ELFTREE (TM) (C) Copyright 1988-1994 By Alan J. Avery This program was written by: Alan J. Avery 1408 Noble Avenue Springfield, Illinois 62704 (217)-698-8600 (8 a.m. to 9 p.m. CDT please!) (217)-698-8601 (FAX - 24 hours a day) Register For Support, Updates To get support for this product and notices of updates, you must register. See the user manual for the registration form. DISCLAIMER The Author specifically disclaims all other warranties, expressed or implied, including but not limited to, implied warranties of merchantability and fitness for a particular purpose with respect to defects in the diskette and documentation, and the program license granted herein. In particular, and without limiting operation of the program license with respect to any particular application, use, or purpose, in no event shall the Author be liable for any loss of profit or any other commercial damage, including but not limited to special, incidental, consequential or other damages. Your use of this program constitutes acceptance of these terms. Introduction ELFTREE is designed to simplify your goal of getting the most out of your computer. The heart of the program is a marvelously powerful file and directory manager. With it, you can install software in record time, move files from one spot to another (even across a network!) with ease, and work with files on even the largest hard disk as if they were in one directory! ELFTREE works with DOS, 4DOS, or any other computer environment that simulates DOS, such as network operating systems or DOS emulators on a Macintosh computer. You won't believe how easy it is to run a program from within ELFTREE, or to customize the colors displayed. You will see in all of ELFTREE's features that great care was taken to marry tremendous power with extreme convenience. The result is a delightful product that will help to make you much more effective. Thousands of ELFTREE users have contributed countless suggestions toward its development over the past 6 years, and most of these have been incorporated. To all of them, THANK YOU!! Your insights and ideas have been a delight to implement, and I look forward to more coding adventures. What Makes ELFTREE Unique? 1. Deceptively Simple - It LOOKS like a ho-hum `shell' program, but its features are rich enough to stretch the talents of any computer professional and simple enough to calm novice users. Designed for easy use with keyboard or mouse. 2. Powerful/Friendly - Gather files (using multiple criteria) from hundreds of directories on many disks, and work with them as if they were in one place! Attach notes to files in any directory (ELFTREE can read/write 4DOS notes directly). Customize it from inside! Format disks in the middle of copying files! Copy files to multiple directories! Clear a subtree of files, or remove it from your disk! Load TSRs from a menu! Use any video mode with at least 25 lines and 80 columns (selects EGA/VGA modes, too)! Lots more! 3. Trim - ELFTREE can run programs with NO overhead! Any program that runs from the DOS prompt can be run from ELFTREE! 4. Thoughtful - Rename a directory and the directory tree is sorted automatically. Remove the current directory and you move to its parent. Try to enter a directory that does not exist, and the tree will be pruned. Display the tree from a newly created directory, and it is added automatically. 5. FAST - Responds instantly to commands! Most commands require tapping only one key (for example, [C] for Copy), and all of the speed-intensive operations are coded in optimized Assembler for the absolute maximum speed! 6. Flexible Capacity - You can specify how much memory ELFTREE uses to manage files, directories, notes, etc.! 7. View Files - The internal viewer can view any type of file through several filters (or in Hex). Scroll the file automatically at any of 9 different speeds. Search forward or backward through the file for text. Advanced block operations are available. EBCDIC files can be viewed as ASCII (or vice versa). 8. Editor - ELFTREE's editor can edit multiple files as large as available memory. The editor is packed with needed features: Column block operations, Normal block operations, 11 stored keyboard macros, FAST search and replace, etc. Unusually Activated Features When you highlight a file with an extension of EXE, COM, BAT or BTM in the file information window and tap [F3], ELFTREE will `preload' the name of that file in the command line that appears. To run the program, you simply tap [Enter]. Alternatively, if you set ELFTREE for Mode: Immediate instead of Mode: Delay, you can skip the [F3] entirely, and just tap [Enter] to run the program. You can train ELFTREE to be sensitive in another way. Say you want to load your word processor when the highlighted file has a DOC extension, or your spreadsheet when the extension is WK1. When ELFTREE is prepared appropriately, just tap [Enter] and the program is launched with that file loaded. Similarly, if you have programs that are designed to view certain types of files, you can train ELFTREE to load the viewer you want by simply tapping [V] once the file is highlighted. Finally, if you have an EGA or VGA (ELFTREE will detect it), you can vary the number of lines displayed on the screen by tapping [Ctrl+V] (think of the V as in VIDEO). Enjoy! Active Keys In ELFTREE The choice of keys used in ELFTREE is designed with your convenience in mind and, with practice, will quickly become familiar. Here is a list of them, and a description of each: Part I - The Elvish Touch Part II - The Mouse Toolbar Part III - File Information Screen Only Part IV - Directory Information Screen Only Part V - Editing Keys Part I - The Elvish Touch Elvish Consulting is proud to introduce The Elvish Touch, which lets you use any feature of ELFTREE without needing more than one finger! (Incidentally, this will NOT interfere with any keyboard handlers you may be using.) For example, suppose you want to locate a file that starts with `E'. In ELFTREE, the keystroke [Alt+E] performs this action, and normally requires you to hold down the [Alt] key and then tap the [E] key. If you use The Elvish Touch, you can also select this by tapping [Alt], and then tapping [E]. Such convenience! Activating The Elvish Touch To activate (or deactivate) The Elvish Touch: 1. Tap [F4] to bring up the Customize menu. 2. Tap [F] to select the Switches submenu. 3. Tap [B] to toggle the current setting. ALT and CTRL LOCK ELFTREE offers a way to `lock' the [Alt] and [Ctrl] keys. For example, to lock the [Alt] key, you tap it twice, and an `A' will appear in the lower right corner of your screen, signifying that [Alt] is in a locked state. While [Alt] is locked, any key that can be affected by [Alt] is. Thus, [E] becomes [Alt+E], [F1] becomes [Alt+F1], etc. To `unlock' [Alt], tap [Alt] or [Ctrl] once, and the `A' will disappear. Also, if [Alt] is locked, you can lock [Ctrl] by just tapping it twice. When [Ctrl] is locked, a `C' will appear in the lower right corner of your screen, and any keys that can be modified are, so [E] becomes [Ctrl+E], etc. It is not possible to lock both [Alt] and [Ctrl] at the same time. This `locking' feature is always available, regardless of whether you have `The Elvish Touch' enabled. Part II - The Mouse Toolbar If a mouse driver is detected and ELFTREE is allowed to use a mouse (see Customize Key/Mouse Settings menu), a toolbar displaying mouse function symbols appears. Here is what each symbol represents: Esc Escape key. Help F1 key. Up Up arrow (repeats). Down Down arrow (repeats). Left Left arrow (repeats). Right Right arrow (repeats). << Page Backward (repeats). >> Page Forward (repeats).  Enter or Return key. Del Delete key. F2 F2 key. F3 F3 key. F4 F4 key. F5 F5 key. F6 F6 key. F8 F8 key. F9 F9 key. F10 F10 key. F11 F11 key. F12 F12 key. Menu Brings up MENU.ETU (attached to U or middle mouse button) Exit Exits ELFTREE immediately (same as [Ctrl+Break]). The mouse toolbar is available any time it is visible in ELFTREE. The user menu in MENU.ETU will only appear from the file screen. Part III - File Information Screen Only MOUSE FUNCTIONS Menu Bar Click on a menu selection to activate it. For example, click on Rename to activate it. Description Double-click to activate help for the highlighted menu item. Drive List Click on a drive letter to change drives. Current Path Click on Drive portion to change drives, click on path portion to show directory tree. ? - Help Click to bring up help screens of what keys are active. Click on a key to simulate tapping it. File Headings Click to cycle forward to next file layout. File Listing Left-click to highlight a file or directory, right-click to tag or untag a file, double-click to simulate tapping [Enter] for this item. Click and hold down a mouse button to move selection bar to another file or directory (files will be tagged or untagged if the right mouse button is held down). If clicked and held on the first or last file in the list, the file display will scroll backward or forward, respectively. If the right button is clicked and held, the files will be tagged/untagged as they are scrolled. Left Edge Click on left edge of screen to simulate [Left] key. Right Edge Click on right edge of screen to simulate [Right] key. Shrink: Click to toggle between 2K and 0K. Mode: Click to toggle between Immediate and Delay modes. Miscellaneous If a box appears on the screen, clicking inside the box (but not on any 'hot spot') usually does the same action as tapping [Enter]. Clicking outside the box (but not on the mouse toolbar) usually does the same as tapping [Esc] to cancel an action. One exception to this is the DOS Gateway box, where if you click on a file name, that name is added to the command line. CURSOR KEYS [Right] Highlights the next choice on the moving-bar menu on the top row, if not in a multicolumn format. [Left] Highlights the previous choice on the moving-bar menu on the top row, if not in a multicolumn format. [Up] Highlights the previous item in the file information area. [Down] Highlights the next item in the file information area. TAB, HOME, END, PGUP, PGDN, Ctrl+PGUP, Ctrl+PGDN [TAB] Advance to the next file display format setting. The possible selections show 1, 2, or 5 files per row or one file-note pair per row. [Shift+TAB] Back to the previous file display format setting. The possible selections show 1, 2, or 5 files per row or one file-note pair per row. [Home] Highlights the first item in the file information area, if in 1-column mode. In multi-column mode, its function depends on how many times you tap it without using any other key. Tap it once, and the highlight moves to the top of the current column. Tap it again, and the highlight moves to the top of the first column. Tap it a third time (or more) and the highlight moves to the first item in the file information area. [End] Highlights the last item in the file information area, if in 1-column mode. In multi-column mode, its function depends on how many times you tap it without using any other key. Tap it once, and the highlight moves to the bottom of the current column. Tap it again, and the highlight moves to the bottom of the last column. Tap it a third time (or more) and the highlight moves to the last item in the file information area. [Ctrl+PgDn] Moves the highlight to the last item. [Ctrl+PgUp] Moves the highlight to the first item. [PgDn] Moves the highlight to the last item on the screen, then on to the next screen, if any. [PgUp] Moves the highlight to the first item on the screen, then back to the previous screen, if any. MISCELLANEOUS KEYS [Space] Tags/untags the current file, highlights the next. [Enter] Selects the item highlighted on the moving-bar menu bar menu on the top of the screen, if in Delay mode. In Immediate mode, this executes the highlighted program (or program associated with it), if possible, enters the directory (if a directory), or selects the menu command, if none of these apply. [Ctrl+Enter] Selects the highlighted item on the moving-bar menu. [Esc] Cancels current operation; exits if none are pending. [ + or - ] Moves to the next or previous directory. [ > or < ] Moves to the next or previous tagged file. [=] Searches for a file name as you type it. ["] Duplicates the highlighted file. [&] Combines two or more tagged files into one. [*] Marks a block of files to be tagged. To use it, move to the first file in the block, tap [*], then move to the last file in the block and tap [*] again. All of the files between the first and last ones will then be tagged. [\] If working with files from more than 1 directory, this jumps to the directory of the highlighted file (and keeps it highlighted). If working with files in just 1 directory, this rereads the current directory, and keeps the same file highlighted. [%] Toggles whether the percentage of slack space for the displayed files should be shown. See the Help section on Sorting files for a description of slack space. [,] Tap this TWICE to cycle among the various characters used to separate thousands in large numbers. [;] Tap this TWICE to cycle through the various time formats. The selections are: HH:MM am HH:MM:SS (24-hour) HH:MM:SSa (12 hour) A through Z Menu Commands for File Display (Note: Tap the first character of a command to activate it.) [T] TAG - To work on a group of files, you `tag' them. To tag the [Space] highlighted file, tap [Space] once and a '' will appear to the left of the name. To clear the tag, tap [Space] again. More tagging options can be found under the Tag command. (There is no need to tag an individual file to work with it.) [A] ATTRIBUTES - You can change file and directory attributes quickly. For example, you will want to make some of your important files read-only so that they can't be erased `accidentally'. Also, you will probably want to hide some of the personal files on your office computer so that a casual snoop won't know they're around. (If you have DOS 3.0 or later, you can run hidden programs!) [C] COPY - You can quickly copy files to another directory or disk. [D] DIRTREE - Display the directories on the current disk as a tree, with the directories in alphabetical order. You can move along this tree to another directory with the cursor keys. You can also create a new directory (N), delete an entire branch of directories, change to a different disk (F6 or L), rebuild the tree (S) find a directory by name (F or =), tag them (Space or T), or hide (H), copy (C), move (M) or graft (G) them. [E] EDIT - You can call up an editor (or word processor) to work on one on one or more files by tagging them and tapping [E]. ELFTREE's editor (available with purchase of ELFTREE) is very helpful. [F] FIND - Lets you gather and manage files from across many directories and disks (even networked drives) as if they were in one place! [M] MOVE - Relocate files to another directory or disk. [N] NOTE - Attach, edit, erase or find notes about files. If you use 4DOS or ProFinder, ELFTREE can read/write their notes directly. [P] PRINT - Print files, or a listing of file names, sizes, notes, etc. [R] RENAME - Renames a file or directory. [S] SPACE - Show space utilitization for all disks, levels of base, EMS or XMS memory, and space allotment for tagged files. [V] VIEW - Browse the contents of files through any of several filters. Any file on your disk can be viewed from ELFTREE. You can search for text, adjust expansion of tabs, print or save portions of the file, or convert portions to upper, lower or proper case. External viewers can be associated by file extension. Off-menu commands: [B] Toggles whether file column borders are shown. [L] Change to the current directory on another disk, or read the same directory (same as [F6] or [Shift+disk]). [O] Shells immediately to DOS. [U] Activates a menu file called MENU.ETU. [Y] Tap this TWICE to change the date format. The selections are: MM/DD/YY YY/MM/DD DD/MM/YY Mon-DD-YY YY-Mon-DD DD-Mon-YY ALT KEYS [Alt+Key] Search for an item whose first letter matches `Key'. For ex, [Alt+A] looks for the next item that starts with `A'. FUNCTION KEYS [F1] Activates the Help system. [F2] Selects sort criteria for file area information. (See [F5] below for further rearranging.) [X] or [F3] Opens the DOS Gateway for entering a DOS command or program to run, or to shell to DOS (use EXIT to return). [F4] Activates customization menu. Change screen colors, name of the editor or format program to use, the speed or delay of the keyboard, or dozens of other settings. TRY IT!!!!! [Ctrl+F4] Toggles between Immediate and Delay modes. (same as [I]) [F5] Helps rearrange the order of items in the file information area to something not achievable via the Sort facility alone. This makes it easy to print files in a certain order. [L] or [F6] Change to the current directory on another disk, or reread or [Shift+disk] the current directory if the same disk is selected. [Ctrl+F6] Displays a table of ASCII characters. [DEL], [F7] Erase a file or, if the highlighted item is a directory, or [Ctrl+K] remove it and all subdirectories. Professional Mode must be activated to remove directories with files in them. [F8] Returns to the directory visited just before this one. [Ctrl+F8] Compares files in the current directory against those in the directory last visited. Tags files that are dissimilar, retags those not in the other directory. [F9] Save the current ELFTREE configuration settings. [F10] Specifies what files you want ELFTREE to show or to exclude. [F11] or Immediately searches for all files on all non-floppy drives [Ctrl+F10] that match the current file specification set by [F10]. [F12] or Immediately searches for all files on the CURRENT drive that [Ctrl+F2] catch the current file specification set by [F10]. CTRL KEYS [Ctrl+Right] If the item highlighted is a directory and the last key tapped was not [Ctrl+Left], this enters that directory. Otherwise, it moves forward to the next directory. [Ctrl+Left] Moves to the Parent directory, or up to the most previous directory if you are in the root directory. [Ctrl+A] Steps through 7 predefined color schemes. [Ctrl+L] Creates a disk volume label. [Ctrl+P] Moves to the parent of the current directory, if any, [Ctrl+V] Toggles between 25 and 43 line modes for EGA displays. Cycles among 25, 28 and 50 line modes on VGA. [Ctrl+T] Changes the date/time stamp for files. [Ctrl+Z] Toggles if ELFTREE shrinks to 0K before running a program. [Ctrl+S] Same as [Left] [Ctrl+D] Same as [Right] [Ctrl+E] Same as [Up] [Ctrl+X] Same as [Down] [Ctrl+R] Same as [PgUp] [Ctrl+C] Same as [PgDn] [Ctrl+F] Same as [Home] [Ctrl+J] Same as [End] Part IV - Directory Information Screen Only MOUSE FUNCTIONS Menu Bar Click on a menu selection to activate it. For example, click on Print to activate it. Description Double-click to activate help for the highlighted menu item. Drive List Click on a drive letter to change drives. Current Path Click on Drive portion to change drives, click on path portion to show the previous file information area. ? - Help Click to bring up a help screen of what keys are active. Click on a key to simulate tapping it. Tree Left-click to highlight a directory, right-click to tag or untag a directory, double-click to simulate tapping [Enter] for a directory. Click and hold down a mouse button to move selection bar to another directory (they will be tagged or untagged if the right mouse button is held down). Left Edge Click on left edge of screen to simulate [Left] key. Right Edge Click on right edge of screen to simulate [Right] key. Miscellaneous If a box appears on the screen, clicking inside the box (but not on any 'hot spot') usually does the same action as tapping [Enter]. Clicking outside the box (but not on the mouse toolbar) usually does the same as tapping [Esc] to cancel an action. CURSOR KEYS [Right] Moves to the first directory below the current one in the next column. If none, it moves to the next one in the same column. [Left] Moves to the parent of the current directory. [Up] Moves to the previous directory in this column. [Down] Moves to the next directory in this column. If none, goes one column to the right, if possible. [Ctrl+Right] Selects the next item on the moving-bar menu. [Ctrl+Left] Selects the previous item on the moving-bar menu. HOME, END, PGUP, PGDN [Home] Moves to the first (root) directory. [End] Moves to the last visible directory. [PgDn] Moves to the last directory on the screen, then to the next screen. [PgUp] Moves to the first directory on the screen, then to the previous screen. MISCELLANEOUS KEYS [Ctrl+Enter] Selects the highlighted item on the moving-bar menu. [Enter] Selects the directory for display of files, then shows the items in this directory. If copying/moving files, this just selects the destination directory. [Esc] Leaves the directory screen; displays files. [#] Displays directory statistics (# of dirs, # hidden, # tagged, #of files in them, total size of files). [Space] Tags/Untags the highlighted directory, updating the combined size of the files affected. [=] Searches for a directory name as you type it. [Plus] or [+] Highlights the next directory in the tree. When you reach the end, it starts over at the first directory. [Minus] or [-] Highlights the previous directory in the tree. When you reach the beginning, it starts over at the last directory. A through Z [C] Copy tagged directories to another disk. [E] Exposes hidden subdirectories of the highlighted directory. [W] or [F] Find a directory by name. (accepts non-DOS names, too!) [=] Searches for a directory name as you type it. [G] Graft (attach) the tagged directories to another directory, either on the same or another disk. The files can be copied or moved. Great for reorganizing your directories or moving some between nodes on a network! [<] or [H] If directories are tagged, this hides them from view (they are still visible from DOS). If none are tagged, this will hide all directories that have not already been hidden that appear to the right of the current column in the tree. (You will be prompted to confirm this.) [M] Move tagged directories to another disk. [N] Make a new subdirectory of the one currently highlighted. [>] or [O] Open Next Level - unhides (opens) the next column of directories that were hidden with the Hide command. [P] Print the directory tree as displayed. [R] Rename the currently highlighted directory. [S] Rebuilds the directory tree for the current disk. [T] Tag the highlighted directory and all subdirectories. [U] Untag the highlighted directory and all subdirectories. ALT KEYS [Alt+Key] Search for a directory whose first letter matches `Key'. For ex, [Alt+A] looks for the next one that starts with `A'. FUNCTION KEYS [F1] Brings up help on using Directories. [F2] Displays current status of many ELFTREE settings. [F4] Customizes the style of the tree. [F5] Rescans the subtree from the currently highlighted directory. [L] or [F6] Display directory tree for another disk. or [Shift+disk] [DEL], [F7] Remove highlighted directory and all empty subdirectories. or [Ctrl+K] If Professional Mode is on, you can remove directories with files in them as well. [F8] Toggles whether the [Enter], [Right] and [Left] keys affect the moving-bar menu selections. [F9] Saves the current directory tree to disk. [F10] Changes what files are used when you select move, copy, graft or [Enter]. CTRL KEYS [.] or [Ctrl+P] Go left to the parent directory of the one highlighted. [Ctrl+V] For EGA adapters, this toggles between 25 and 43 line modes. For VGA, this cycles among 25, 28 and 50 line modes. [Ctrl+S] Same as [Left] [Ctrl+D] Same as [Right] [Ctrl+E] Same as [Up] [Ctrl+X] Same as [Down] [Ctrl+R] Same as [PgUp] [Ctrl+C] Same as [PgDn] [Ctrl+F] Same as [Home] [Ctrl+J] Same as [End] Part V - Editing Keys (for editing popups only) CURSOR KEYS [Right] Moves the cursor one column to the right. [Left] Moves the cursor one column to the left. [Home] Moves the cursor to the start of the field. [End] Moves the cursor to the end of the field. [PgUp,PgDn, Up,Down] Ends editing (unless in DOS window). OTHER USEFUL KEYS [Insert] Toggles between Insert and Overtype mode. [Delete] Deletes the character at the cursor. [Backspace] Deletes the character to the left of the cursor. [Ctrl+Backspace] Deletes all characters immediately. [Ctrl+End] Deletes all characters from the cursor on. Sorting Files Key: [F2] ELFTREE provides numerous ways to order the files in the list. This lets you look at them in many different ways and quickly reorganize them. To prepare a sort, tap the [F2] key or click on F2 on the mouse toolbar. A menu will appear, listing the sorting options available (Name, Extension, etc.). These are explained below. The primary sort order is highlighted, with either a '+' to the left of it (for Ascending order) or a '-' to the left (for Descending order). For example, ELFTREE's default primary sort is ascending order by name, so Name is highlighted, with a '+' to the left of it. To sort the items by Size in descending order, tap [-] to select descending order, then tap [S] to select the Size option. If using a mouse, clicking on a sort menu option will immediately sort the files using that selection. In the area just below the menu options, clicking on [+/-] will select Ascending or Descending order, respectively, clicking on [Esc] will cancel the sort, clicking on [SP] will toggle the +/- setting, and clicking on [Enter] will perform the sort. If two or more items are 'tied' after being compared with your primary sort option, you may wish to specify a secondary sort option to tell ELFTREE how to break the tie. To do this, choose F2 again (immediately after selecting the primary sort), and select the option to use for breaking ties from the menu. Repeat this if you wish to specify a third or fourth level sort option to break ties. (The level currently being set is indicated on the last line of the menu options window.) Here is a description of each of the Sort menu options: BY NAME When you sort these items by name, the displayed files will be listed in name-first order. For example, TODD.DOC would come after STEVE.TXT, if the sort were in ascending order. BY EXTENSION After sorting by extension, for example, FIRST.BAS would precede ALPHA.COM. In ascending order, an item with no extension would precede any with an extension. BY SIZE When you sort your items by size, and choose descending order, the largest files would be listed first, and the smallest ones last. BY DATE/TIME With this sort selected, if you choose ascending order, the oldest files would be listed first, and the most recent listed last. Files with identical dates are compared by time. If you do not wish to have times compared automatically, select the Date Only option. BY DISK ORDER This option will list the items in the order in which they are on the disk, or in the reverse of this order. One way this can be used by you, for example, is if you want to put frequently accessed files near the top of the chain, so DOS can find them faster. To do this, first arrange the files in the order you want them to be chained (use the REARRANGE key [F5] if needed), then move them to a new directory, then move them back to this one. (Or delete the old directory and rename this one.) BY ATTRIBUTE Sorting items by attribute is handy when you want to group all files of similar attribute together, such as archived files that need to be copied to a disk for backup. BY TAG This option lets you group all of your tagged, retagged and untagged files together. BY PCT SLACK When a file is stored on a disk, it may not use all of the space assigned to it. The term `slack' refers to that portion of the assigned space that does not contain data for that file. For example, a 12-byte file may be allocated 2,048 bytes of disk space, which `wastes' 2,036 bytes of storage. This option lets you order the files by the percentage of wasted, or slack, space. BY DATE ONLY This sort groups files with identical dates together. If you select ascending order, older files would be listed before newer ones. BY TIME ONLY This sort orders files by time of creation. This can be handy, for example, to see if anyone created any files in the wee hours of the morning, or when you were away at lunch. NOTE: You can rearrange the file display in a manner impossible by just sorting with the Rearrange [F5] key. This lets you move one item at a time to a new position up or down in the display. DOS Gateway Keys: [F3] or [X] The facilities available to you through the DOS Gateway let you: 1. Run a program with 2K or ZERO K of RAM overhead! Imagine yourself pointing to a program to run, tapping [Enter], and ELFTREE loading it! Then, when you exit the program, ELFTREE reloads itself automatically. 2. Select commands from one of billions of menus that you create (up to 100 commands per menu and 10 levels of submenus with comments and user-specified Help lines and selector characters). 3. Execute DOS commands easily. In addition, ELFTREE remembers the last 15 unique commands you used. It also provides a quick, temporary exit to DOS (tap [O]), so you can work with DOS (or 4DOS) for a period of time, if you need to, then return to ELFTREE when ready. 4. Use short symbols to represent items that you want to include in one or more commands. Here is a listing of them: Group 1 - Macro symbols that provide objects for commands: Symbol Alternate Description ======== ========= =========================================== {CName} #C Drive:\Path\Name.Ext of current file {Date} #V Current date {Dext} #] Extension of current directory {Dir} #| Name.Ext of current directory {Dname} #[ Name of current directory {Drive} #4 Current drive (e.g. [A:]) {Editor} # Name of currently defined editor. {ETFind} # Path to ETFIND directory. {Ext} #E Extension of current file {FName} #F Name.Ext of current file {FDate} #G Date of current file {FNote} #7 Note on current file {FTime} #H Time of current file {FSize} #5 Size of current file (flush left) {LDrive} #? Former drive (e.g. [C:]) {List} #L Execute command against list of tagged files {LPath} #/ Formerly displayed path {Name} #N Name of current file {Page} #P Current page (use for printing) {Path} #\ Currently displayed path {RSize} #6 Size of current file (right-justified) {Temp} #@ Insert name of filenames of tagged files {Time} #X Current time Group 2 - Macro symbols that control command actions: Symbol Alternate Description ======== ========= =========================================== ^ Join multiple commands {COM1} #A Send string to serial port COM1 {COM2} #B Send string to serial port COM2 {DInput} #0 Default response to user input query {ExitC} #. Exit to current directory after completion. {ExitO} #, Exit to original directory after completion. {Free} #* Free file space before executing program. {GTag} #8 Run command group for each tagged file {Input} #I Ask user for input to a command. {LPT1} #1 Send string to printer port LPT1 {LPT2} #2 Send string to printer port LPT2 {LPT3} #3 Send string to printer port LPT3 {Macro} #J Stuff ELFTREE keyboard buffer for macro {Menu} # Displays menu, puts on command line. {MoveTo} #D Move to program directory before executing. {NoSaveTag} #} Don't save file tags before executing command. {NoWait} #! Don't wait for a key after command execution {Nozero} #Y Don't shrink to 0K {Prompt} #Q Prompt user with message before continuing {Repeat} #R Repeat last command until user stops {Repeatall} #M Repeat all commands until user stops {Retag} #O Re-tag file after execution completes {SaveTag} #{ Save file tags before executing command. {Stuff} #K Stuff DOS keyboard buffer before execution {Tag} #T Run command for each tagged file {UInput} #U Response to previous user input command {UMenu} # Response to previous {Menu] or {XMenu}. {V25} #( Select 25-line video mode (all displays). {V43} #) Select 43-line video mode (EGA only). {V28} #- Select 28-line video mode (VGA only). {V50} #= Select 50-line video mode (VGA only). {VKeep} #9 Keep current video mode. {Wait} #W Wait for a key after command execution {XMenu} # Displays menu, does NOT put on command line. {Zero} #Z Shrink to 0K prior to command execution IMMEDIATE MODE If ELFTREE is set up for Immediate mode, and the item highlighted is a program that can be run, or has an extension that ELFTREE is sensitive to, you launch the program by just tapping [Enter] or double-clicking with the left or right mouse button. DOS WINDOW Tap [F3] or [X] (or click on F3 in the mouse toolbar) to open the DOS Gateway. A window will appear, with a line in which to type a command. For example, you could type the command DIR A: to get a directory listing of the A: disk, or DATE to change the system date. Once entered, tap [Enter] or click inside the box to carry out the command. To clear the text on the line, tap [Ctrl+Backspace] or click on this symbol on the line below the command. Tap [F3] to put the current file's name on the command line or, if using a mouse, click on a file to put that file's name on the line. COMMAND SHORTCUTS ELFTREE offers you additional power by allowing you to combine multiple commands, to use short symbols for commonly used objects such as the name of a file, or to execute a command against all tagged files. Here are examples: - Multiple commands (use ^ to separate each command): cd \^print config.sys^dir c: - Insert file or directory information: echo Last Drive:{LDrive} echo Last Path:{LPath} echo Current Drive:{Drive} echo Full Current Path:{Path} echo Short Path:{Dir} echo Current Dir Name Only:{DName} echo Current Dir Extension:{DExt} echo Complete Name:{CName} echo File Size:{FSize} echo Right-Justified Size:{RSize} echo Full Name:{FName} echo Partial Name:{Name} echo Extension:{Ext} echo File Note:{FNote} echo File Date:{FDate} echo File Time:{FTime} - Insert other information. echo Current Date:{Date} echo Current Time:{Time} echo Your Editor:{Editor} echo ETFIND Dir:{ETFind} - Change current directory, run a command, and return. C:\QPRO\Q.EXE {MoveTo} (changes to C:\QPRO, starts up Quattro Pro, and returns to the original directory when done.) - Run a command against a list consisting of the names of the tagged files. (DOS allows only 127 characters total!) archive -a saveme {List} - Run a command against a file consisting of the names of the tagged files (1 name per line). Very useful for archiving! archive -a saveme {Temp} archive -a saveme {Temp} {NoZero} (do not shrink to 0K) archive -a saveme {Temp} {Zero} (shrink to 0K) - Ask for user input, with an optional message. dir {Input}"Directory Name?" dir {DInput}"{Path}"{Input}"Directory Name?" dir {DInput}"{Path}"{Input}"Directory Name?"^cd {UInput} Notes: A message must be surrounded by double quotes. In the second and third examples, with {DInput}, the current path is inserted before {Input} is called. Be sure to type {DInput} BEFORE {Input} when using this! To just give the user a message and have them tap a key to continue, use {Prompt} instead of {Input}: dir A:{Prompt}"~~Insert a disk in drive A" - Pop up a small menu of items: echo {Menu}"Choice 1,Choice 2,Choice 3" echo {XMenu}"Choice 1,Choice 2,Choice 3"you chose {UMenu} Notes: {Menu} causes the item to be placed into the command line. To just display the menu, use {XMenu}. To insert the last selection from {Menu} or {XMenu}, use {UMenu}. - Stuff the DOS keyboard buffer, then execute the command. backup {Stuff}12~ Note: These character(s) have special meaning: ~ - [Enter] ` - [TAB] @ - [Esc] ? - Pauses macro until [Enter] is tapped. =1 - [F1] (similarly for F2,...,F9) =0 - [F10] +1 - [Shift+F1] (similarly for [Shift+F2],...,[Shift+F9]) +0 - [Shift+F10] (1 - [Ctrl+F1] (similarly for [Ctrl+F2],...,[Ctrl+F9]) (0 - [Ctrl+F10] (A - [Ctrl+A] (similarly for [Ctrl+B],...,[Ctrl+Z]) )1 - [Alt+F1] (similarly for [Alt+F2],...,[Alt+F9]) )0 - [Alt+F10] )A - [Alt+A] (similarly for [Alt+B],...,[Alt+Z]) !1 - the cursor key with `1' on it (i.e., End) (similarly for !2 [DownArrow],..,!9 [PgUp]) [1 - [Ctrl] + the cursor key with `1' on it (i.e., [Ctrl+End]) (similarly for [2 [Ctrl+DownArrow],..,[9 [Ctrl+PgUp]) Macro expansion continues after a {Stuff} is encountered; the keyboard is not stuffed until all have been resolved. (up to 15 characters can be stuffed, unless your computer is using a product such as THE BUFFER STUFFER that can expand the DOS keyboard buffer to a larger size) For example: Load Spreadsheet$C:\QPRO\Q.EXE {Stuff}/fo{Name} This stuffs the keyboard with `/fo' followed by the name of the highlighted file. - Stuff the ELFTREE keyboard buffer. Up to 5000 keys can be stuffed using this option (you must use the command-line switch /K=#### to get more than the default of 100, however - see the Help selection on Customize). {Macro}ca~y Note: This stuffs the characters [c], [a], [Enter] and [y], then processes them) - Make ELFTREE repeat a command, wait (or not wait) after execution, process one command (or more) once for each tagged file. print {Fname}{Repeat} echo {FName}>PRN ^print {Fname}{Repeatall} print {Fname}{Wait} print {Fname}{NoWait} print {Tag}{Fname} echo {GTag}{FName}>PRN ^print {Fname} - Set (or keep) the video mode before execution. echo {V25}Now in 25 line mode. (EGA/VGA) echo {V28}Now in 28 line mode. (VGA) echo {V43}Now in 43 line mode. (EGA) echo {V50}Now in 50 line mode. (VGA) echo {VKeep}Video mode was not changed. - Represent the current page number. Note: Use this in a page header when printing. {Date} {Time} Page {Page} - Send a string to one of three printer ports. {LPT1}"See me at port 1" {LPT2}"See me at port 2" {LPT3}"See me at port 3" - Send a string (enclosed in double quotes) to a serial port. Note: if a modem is hooked up to COM1, this can dial a number. {COM1}"ATDT1-800-555-1212~" {COM2}"ATDT1-800-555-1212~" The ~ character is converted to a carriage return before before the string is sent, and the symbol \0 is converted to a null - binary zero - before sending. These special characters, called macro symbols, give you a way to create powerful commands. They are especially useful when part of an ELFTREE user menu (described next) or with ELFTREE's extension sensitivity (three sections down). USER MENUS ELFTREE can automatically load one of 13 menus when you tap the key it is attached to. These menus can be activated from the file information screen or the DOS Gateway, and they can each nest other submenus up to 10 levels deep. You can also make ELFTREE load a menu by attaching it to a specific file extension. See the section below on Extension Sensitivity for more information. The keys to which you can attach a menu are [U] (from the file information screen only), [Alt+U] (from the DOS Gateway only), and [Alt+F1] through [Alt+F12] (from either the DOS Gateway or the file information screen). Note that you must have an enhanced keyboard to use F11 and F12. If you have a three-button mouse, clicking the middle button will bring up the menu MENU.ETU from the File Information screen. From the mouse toolbar, clicking on Menu will bring up this menu also. To attach a menu to [Alt+F2], just tap the [Alt+F2] key or hold down the [Alt] key with one hand and click on [F2] with the left or right mouse button. You will be told that the menu does not exist, and will be asked if you want to create it now. Answer [Y]. This loads the editor with the menu file ALTF2.ETU. On each line of this file, type a command you want to appear on the menu, preceded by a label (recommended, but not required). Each line may be up to 500 characters in length (not including label); follow each label by a single $ symbol. COMMENTS To include a comment line in your menu file, put an asterisk (*) in the first column of the line. If you want a comment to span several lines, just begin EACH line with an asterisk. USER-DEFINED HELP To designate a line of text as a help descriptor for the next menu selection, put an exclamation point (!) in the first column. When you highlight a menu line that has Help associated with it, this Help text will appear (centered) at the bottom of the menu panel. USER-DEFINED SELECTOR By default, the first character of each label denotes a key that, when tapped, selects that item. If you wish a different selector to be chosen for an item, just put an `@' symbol in front of the character you wish to be used as the selector. Here is the menu SAMPLE.ETU that comes with ELFTREE: :Sample ELFTREE Menu *** * This is to get you started designing a menu in ELFTREE. * The basic ideas are: *** * : Starts a menu TITLE. * * Starts a COMMENT line. * ! Starts a HELP line. * @ Precedes the KEY that selects the item. * $ Starts a COMMAND (and ends a menu description). * Commands immediately follow the dollar symbol. * Commands can use special symbols. See ELFTREE.HLP file for more info. * Menu names (with extension .ETU) can be used as commands. *** * Sample menu commands: * * Put the menu After the dollar ($) * description symbol, put the * here command * * *    Print @README.DOC $copy {ETfind}\README.DOC PRN Print @AUTOEXEC.DOC $copy {ETfind}\AUTOEXEC.DOC PRN Print @FEATURES.ET $copy {ETfind}\FEATURES.ET PRN Print @Help file $copy {ETfind}\ELFTREE.HLP PRN Print @Order form $copy {ETfind}\ORDER.DOC PRN Print @Site License $copy {ETfind}\SITELICE.DOC PRN Print S@ystem files $copy c:\config.sys prn^copy c:\autoexec.bat prn * !Note: You must have PKZIP for this to work. Zip tagged files $PKZIP -a {Input}"Enter name of archive file:" @{Temp}{Nowait} !Note: You must have PKUNZIP for this to work. Unzip tagged files $PKUNZIP {Tag}{Fname}{Nowait} !Note: You must have PKZIP for this to work. Show ZIP file @contents $PKZIP -v {Fname} You may use any of the special macro symbols defined in the preceding section as part of the command for a menu selection. All menu files you create must be stored in the directory where you store your global search files (the environment variable ETFIND is used to determine this - if you don't have one, then the menus go into the directory where ELFTREE is stored). Tap [Alt+F2] to activate the menu in ALTF2.ETU. To select an item from it, use the cursor keys or the mouse to highlight it, then tap [Enter] or double-click on it. Or, tap the key corresponding to the first character of the item. If the selected item does not have a label, and you activated the menu from the DOS Gateway, it will appear on the command line so that you can modify it. Otherwise, it will be executed immediately. If you decide that you want to make a change to your menu, just tap [Alt+E] or click on the [Alt+E] symbol, and ELFTREE will let you edit it again. If you wish to make a menu for [Alt+F3], follow the same procedure, but tap the key [Alt+F3] to get started. You can put up to 100 selections in each menu file. The menu attached to either [U] (or [Alt+U]) is named MENU.ETU, and is stored in the same directory as all of the other menus. SUBMENUS To set up a menu item as a submenu, simply type the name of the menu file (it must have the extension .ETU and be located in the same directory as the other menus) after the '$' symbol. Here is an example of a menu with both commands and submenus: Utilities Menu $UTILS.ETU * !Format Disk in Drive A: Format disk $format a: * Spreadsheet $C:\QPRO\Q.EXE * Database Menu $DBASES.ETU * Project Menu $PRJ.ETU Select a submenu like any other menu item; just highlight it and tap [Enter], or tap its selector key. The submenu will appear. Make a choice from the submenu, or tap [Esc] to return to the parent menu. IMMEDIATE KEYS If you create a menu with one selection, then tap the key for that menu, ELFTREE will select that item IMMEDIATELY if you are in Immediate mode . This convenience lets you use menus as "Immediate Keys", or keys that carry out a command immediately upon activation. In other words, if you are in Immediate mode, ELFTREE will only display a menu if it has more than 1 selection on it, otherwise it will execute the command in it IMMEDIATELY. AUTOMATIC LOADING When the currently highlighted file has an extension of EXE, COM, BAT or BTM, the name of the file will appear in the command line when the Gateway is activated. This design lets you execute a program by first pointing to it, then tapping [Enter], or by merely double-clicking on it with the mouse. ELFTREE can be much smarter than this, however. Read on. EXTENSION SENSITIVITY You can make ELFTREE start your word processor when the highlighted highlighted file has an extension of, say, DOC, or your spreadsheet program when the current file's extension begins with W, or to show a user-defined menu of commands if the extension is, say, ZIP. To do this, tap [Alt+Enter] (or press [Alt] and click on the [Enter] symbol) and type an ASCII file with this layout (the file extension is in the first 3 columns): DOC C:\MSWORD\WORD.EXE /c (parameters can be used) W* C:\QPRO\Q.EXE (DOS wildcards can be used) R?D C:\REFLEX\REFLEX.EXE {Fname} (macro symbols can be used) ZIP ZIPSTUFF.ETU (user-defined command menu) The file is named PROGRAMS.ELF and stored in the same directory as the other ELFTREE files. Any time you read this directory (or at startup), ELFTREE will be `sensitized' to these extensions. Once sensitized, when you highlight the file REPORT.DOC (for example) and tap [F3], the DOS window will pop up, and the command line will look like this: C:\MSWORD\WORD.EXE REPORT.DOC Now, tap [Enter] (or click on it) and the program will be started. Up to 40 extensions can be used in this file, and they can use the wildcards `*' and `?'. Notes: In Immediate mode you can tap [Enter] on a file with a special extension and have ELFTREE load the program (and file) Immediately. Tap [I] to toggle Immediate mode. ELFTREE will allow you to have multiple PROGRAMS.ELF files. When you enter a directory, ELFTREE looks for a PROGRAMS.ELF file and, if it finds one, `resensitizes' itself to what is in this new one. When you then move on to another directory, ELFTREE stays sensitive to these extensions. See the help on Viewing A File for related information. RAM USAGE When you run a program from ELFTREE using one of these methods, it will release all but 2K of RAM to it! This lets you run memory- hungry programs without worries about whether there's enough memory free. For BAT or BTM files, ELFTREE frees up all but 6 or 7K, depending on which DOS (or 4DOS) you use. ZERO RAM USAGE To make ELFTREE unload itself completely from memory before running a command or program, do one of these: 1. Use {Zero} somewhere in the command. 2. Tap [Ctrl+Z] once from the file information screen. 3. Click on Shrink: in the file information screen status line. When unloading completely, ELFTREE builds a file called ETRUN.BAT, then exits and runs this file. Because ELFTREE has to stuff the keyboard with ETRUN~ before unloading itself, {Stuff} only has room for 9 keys (15 total). The ETRUN.BAT file is built in the directory where ELFTREE stores all of its menus, trees, configuration files, etc., and is erased when ELFTREE restarts. GO TO DOS To go directly to DOS from ELFTREE, just clear the DOS Gateway command line and tap [Enter]. All but 6 or 7K of RAM is released. The fastest way to get to DOS is to tap [O] from the file list. ELFTREE REMEMBERS ELFTREE stores the last 15 commands entered in its DOS window. You can cycle through a menu of them by tapping the [DownArrow] and [UpArrow] keys or clicking on their respective symbols on the mouse toolbar. To clear a command you no longer want remembered, tap [Delete] or click on Del. To select the highlighted command, tap [Enter] or double-click on it. To not select a command, tap [Esc]. To clear the command line, tap [Ctrl+Backspace] or click on this symbol beneath the command line. PROBLEMS If a program refuses to run from inside ELFTREE, try this trick: Type the phrase COMMAND.COM /C before the program name. Here's an example of what this might look like: COMMAND /C PESKY.EXE If this doesn't work, then have ELFTREE completely unload before trying to run the program. See the section above on ZERO RAM USAGE for more information. If none of these methods works, but the program runs fine from DOS, please call so we can help you get it fixed! Customizing ELFTREE Key: [F4] You can easily customize ELFTREE from within it! There is no separate installation program to run. You can change the colors displayed on the screen or the borders to use for popups, speed up or slow down your keyboard, tell ELFTREE what items you want to see when it shows you the contents of a directory, specify what editor (or word processor) to use when you invoke EDIT, and set dozens of other options. In addition, you can tell ELFTREE how much memory to use for files, directories and other items. NOTE: For all of these, you must SAVE [F9] your settings before leaving ELFTREE, if you want ELFTREE to use them the next time. START CUSTOMIZATION To customize, tap the [F4] key or click on the F4 symbol in the mouse toolbar. A menu will appear, showing what items can be changed. Some of these items are themselves menus of options. Select an item to work with by tapping the key for it, by highlighting it and then tapping [Enter], or by clicking on it with the mouse. Next is a description of each menu option. Screen Colors/Borders (Submenu) This menu allows you to change the colors of various screen elements or the types of characters used to draw borders for boxes or columns. Here is a brief description of each: BOX BORDER TYPE This determines the border (box) used on popup prompts and menus. When selected, the inside of the menu will change to a prompt telling you what to do next. Use [UpArrow]/[DownArrow] to cycle forward/backward through the border styles. Continue until you find one you like, then tap or click on [Enter] to keep it. If you don't want to change the style, just tap or click on [Esc]. FILE BORDER TYPE This gives you additional control over whether borders will be drawn to separate the file information displayed, and lets you choose the border that is most visually appealing. Nine (9) types of borders are possible (including none at all). To select one, tap or click on [UpArrow]/[DownArrow] to cycle forward/backward through the selections and, when you spot the one you want, tap or click on [Enter] to keep it. Tap or click on [Esc] to cancel the selection. If you chose no border at all, ELFTREE will display at least four (4) more lines of file information. COLOR SELECTIONS When you select a color option, a color table will appear in the lower right corner of your screen, and the cursor will be located at the current color of the item you selected. Just move the cursor to the color you want (or click on a color), and watch how the color of the selected item changes. When you have found the color you want, just tap or click the [Enter] key to keep it. Tap or click on [Esc] to go back to the original color for that item. EDITOR PROGRAM NAME ELFTREE has its own editor that can edit multiple files quickly and efficiently. You can also use your favorite editor or word processor with ELFTREE. To indicate your editor, select [B] from the menu, and fill in the box with the name (use the drive and path if you know them) of the editor you want to use. For example: C:\EDITOR\MYEDIT.EXE Next, tell ELFTREE what parameters you wish to be included with each invocation of the editor, if any. Feel free to use ELFTREE's powerful macro symbols among the parameters. Then, you'll be asked if your editor needs lots of memory. If you answer [Y] to this, then ELFTREE will shrink itself to 2K of RAM before loading the editor, giving it maximum RAM. After you've entered all this, ELFTREE will check to see if the editor is available, and will tell you if it cannot find it. FORMAT PROGRAM NAME To format disks with ELFTREE, you need to tell it the name of your formatting program. Most people use the one supplied with DOS, which is called FORMAT.COM or FORMAT.EXE. Fill in the box with the name that applies to your machine, if you know it. If you know the directory it is stored in, enter this as well. Next, tell ELFTREE what parameters to use every time it invokes the formatting program. You should NOT enter any disk letters such as A: or B:, ELFTREE will supply these when they are needed. In fact, under normal circumstances, you will rarely need to enter any parameters here. However, if you format disks of varying density on a high-density, you will need to supply parameters at that time. See the manual for information on building a FORMAT.ETU menu. Ask your system specialist if you need help. Tip: If your computer has 2 or more different diskette drives, you can create a menu of format parameters and use the name of this menu on the parameters line. KEY/MOUSE SETTINGS (Submenu) This option pops up a window showing the current keyboard delay and key repeat rate, and whether a mouse should be used. To change the delay, tap or click on [A] or [Space] to cycle through the 4 choices (1/4, 1/2, 3/4 and 1 second). To change the repeat rate, tap or click on [B] to cycle through the choices. To test the current delay/repeat selection, press (or click) and hold the [Up] or [Down] arrow keys. The default settings are a 1/2 second delay and a repeat rate of 30 keys per second. Tap [C] to toggle whether ELFTREE should look for and use a mouse (if present). This resets any mouse driver and displays or hides the mouse toolbar on line 1 of the screen. The default is Yes. Note: Not all computers allow the keyboard to be customized. Miscellaneous Settings (Submenu) These settings control various features of how ELFTREE behaves when it is started, exited, looking for files, idle, searching for text, or responding to command-type keystrokes. Here is a brief description of what each option controls: MODE Tap or click on [A] to change the Mode setting. The choices are Delay and Immediate. In Delay mode (the default), a submenu choice is automatically highlighted and ELFTREE waits for the user to choose the next option. In Immediate mode, ELFTREE automatically selects the highlighted option without requiring the user to tap another key (or click once more with the mouse). Here's an example: Suppose you tag a few files and choose the Copy tool. In Immediate mode, ELFTREE will assume that you want the tagged files copied, so it will activate automatically. In Delay mode, you have to tap [T] or [H] to specify your choice. Delay mode thus offers maximum flexibility, but Immediate mode offers maximum speed. Immediate mode has other advantages. If the highlighted file is a program, or the data file associated with a program that you've trained ELFTREE to recognize, you can run it by simply tapping or clicking on [Enter]. If a directory is highlighted, you can enter it by tapping [Enter] or double-clicking on it. This makes ELFTREE even simpler to use. Note: From the file screen, tap [I] or click on the Mode setting in the file statistics line to toggle the mode. CASE (looking for text) Tap or click on [B] to change the Case setting, which is used when searching for text. By default, upper and lower case are considered equal when searching so that, if you were searching for ELFTREE, it would find elftree, Elftree, ELFTREE and so on. The four (4) choices for Case are: Respect - find exact matches only. Ignore - find matches that agree except for case. Ask - ask about case sensitivity before searching. Smart - If the string to look for has both UPPER and lower case characters, then case is respected, otherwise it is ignored. For example, a search for `Copyright' would respect case, but not for `copyright'. OPEN CHOICES Tap or click on [C] to change what ELFTREE shows at startup - Files, Tree or Menu. The default is Files, which shows the files from the current directory. You may prefer to always see the directory tree first, however, or the commands you've put into a menu file. If you choose `Menu', you can control which main menu will appear with the STARTUP MENU option. EXIT CHOICES Tap or click on [D] to change how ELFTREE exits. You can have it always drop you off in the Current directory or the Original directory (where you started ELFTREE up), or you can make it always ask before exiting. This latter option is handy if you tend to `lean' on the [Esc] key. The default is Ask. STARTUP MENU When ELFTREE is told to Open In a menu (see above), you can tell it which menu to open to with this. Every time you select this option, the next possible menu is selected. There are 13 menus that can be initiated on startup, and they are attached to the [U] and [Alt+F1]-[Alt+F12] keys. For example, if MENU.ETU is the current choice, then ALTF1.ETU would appear next when you select this option. Tap or click on [E] to cycle through the menus. SCREEN SAVE Tap or click on [F] to make ELFTREE blank the screen after a certain number of minutes of inactivity. Enter how many minutes to wait before blanking the screen in the box provided. To not have the screen blanked (the default), use a setting of 0. To make ELFTREE immediately blank the screen, hold down both [Shift] keys on your keyboard. When the screen is saved, a message can appear at random locations indicating this. The file SNOOZE.ELF contains these messages, so you can change them by editing the file. Up to 40 messages can appear in this file. Each message can span several lines, and must be separated from each other by a blank line. (If no SNOOZE.ELF file is present, no message is displayed.) To bring the screen back, just tap a key or click or move the mouse. FILE SEARCH SPEC Tap or click on [G] to change what files and/or directories will be displayed in the file information area. Two steps are needed: Step 1- tell ELFTREE what names to use when it is looking for things to show you. When you first start ELFTREE, this is "*.*", which means "show me everything that's out there". However, you might want ELFTREE to display only your memos, which have an extension, say, of MMO. No problem! Just enter *.MMO, and only these will show. However, you may want ELFTREE to display files that match a group of names, instead of what can be given in one specification. To do this, simply type more such specifications, separating each item by a colon (:). (For your convenience, semicolons are changed to colons.) For example, to bring up only files with an extension of .COM, .EXE or .BAT, this will do the trick: *.COM:*.EXE:*.BAT ELFTREE understands search specifications that DOS cannot, such as "*94*", which means "show me files that have 94 in the name", or "AB*C*DE", which means "show me files that begin with AB, end with DE and have C somewhere between them". If no file specification is supplied, the default is "*.*". Regardless of the file specification you enter, you have the option of `reversing' it - that is, show all files EXCEPT those that match this spec. To reverse it, just tap or click on [F10] instead of [Enter] when you are through typing in the specification. Step 2 - Indicate what types of items that have such names should be included. You can specify hidden, system, read-only, or archived files, and you can specify whether directories, labels, or files with no attributes (called Normal files by DOS) are included. If a selection on this menu has a Yes by it, then it will be included; otherwise, it will be excluded. By default, files that are marked as Hidden and/or System are not displayed (and you should NOT change any files with these attributes already set!). To change a Yes to a No, or vice versa, just highlight the selection and tap or click on [Space], or tap or click on that item's selector key. PROGRAM SHRINK Tap or click on [H] to change how ELFTREE shrinks itself when running a program. It can either leave a small kernel of itself (about 2K) in memory (the default), or not. NOTE TYPE Tap or click on [I] to choose the type of note file ELFTREE uses. This file is used to store notes about files and directories. The three types are ET (the default), 4DOS and ProFinder. If you use 4DOS (a shareware replacement for COMMAND.COM), you will most likely want to use the 4DOS selection so that you can edit the notes in ELFTREE but still have the changes kept in 4DOS. Switches (Submenu) This menu controls the operation of various switches, such as how ELFTREE responds to the Alt and Ctrl keys, whether borders appear between the columns of file information, whether noise feedback is permitted, etc. ALT/CTRL LOCK Tap or click on [A] to toggle whether the Alt or Ctrl keys can be 'locked' by tapping either one twice. Once locked, the behavior of normal keys is modified by the status of the locked key. For example, [A] becomes [Alt+A] or [Ctrl+A]. This was designed as a convenience to those users for whom typing is a challenge, but it can also be used to circumvent the action of a `hotkey' for a resident program. ELVISH TOUCH Tap or click on [B] to toggle whether the Alt or Ctrl keys must be held down simultaneously when selecting a key. When activated, you can enter [Alt+A] by tapping [Alt], then [A]. This is handy for people who find typing bothersome, such as people with arthritis, or executives who are not used to typing on a keyboard. FILE COLUMNS Tap or click on [C] to toggle whether vertical lines separate the columns of file information. The default is Yes; however, columns will still not be shown if the border type (see next item) is hidden. Note: Tap [B] from the file screen to toggle this setting. QUIET Tap or click on [D] to toggle whether ELFTREE is allowed to beep when it needs to get your attention. The default is Yes. STORE TREE Tap or click on [E] to toggle whether directory trees for fixed disks are stored so that they do not have to be rebuilt each time a disk is accessed (this is the default). VIEW SHRINK When you tap [V] to view a file, ELFTREE checks to see if it should run an external program to view it (this is controlled by the file VIEWERS.ELF). If it finds one, this option determines whether it shrinks itself prior to running the viewing program. DIRS FIRST When ELFTREE grabs the files from a directory, and the directory has subdirectories, this option controls whether they always appear at the beginning of the list, or if they will be mixed with the files. If they are placed at the beginning, they will always be in alphabetical order. (This option does not apply to files gathered from the Find command.) GROW POPUPS When ELFTREE opens a window to give you a message or to have you type in some text, it can either open the window immediately at full size, or grow it a bit more slowly. This option lets you control how the windows appear. Choose 'Yes' (the default) if you prefer flashier popups, and 'No' if you prefer instant popups. VALIDATE TREE When you display the directory tree, a quick check is done to see if any subdirectories have been added to the current directory, or if the tree may need to be rebuilt. Choose 'Yes' (the default) to activate this option, and 'No' to deactivate it. SET ARCHIVE When a file is copied or moved from one location to another, the file's attributes are copied also. Making this option 'Yes' ensures that the archive attribute 'A' is set for the target file. The default is 'No'. SAVE COMMANDS When you exit ELFTREE, commands entered through the DOS Gateway or the Menu system can be saved by setting this option to 'Yes'. The default is 'No' (commands are not saved). SCAN CONFIRM When you tap [S] to rescan a directory tree, you will be asked to confirm it if this option is set to 'Yes' (the default). SHOW NOTE LETTER Setting this option to Yes displays the first letter of a note instead of the paragraph symbol (ASCII 20). The default is 'No'. SHOW FILE SPEC Setting this option to Yes displays the file search specification on the screen line just above the file status area. SHOW NAME.EXT Setting this option to Yes displays file names as NAME.EXT instead of putting the extensions in a separate column. DEL BEFORE COPY Setting this option to Yes forces a file to be deleted before it is copied over. This is handy for people using a program that puts deleted files in a protected directory. Advanced Switches (Submenu) This menu controls numerous options that are of concern to the person who uses ELFTREE intensively. ALWAYS FREE FILESPACE This option makes ELFTREE more aggressive in reducing memory before running programs that do not ask it to shrink. With this activated, memory for files, directories and notes is freed prior to running a program, and reallocated afterwards. (If not activated, ELFTREE will still free such memory if it detects that the program might need it.) COPY OVERWRITE When copying or moving files, ELFTREE is careful not to overwrite any existing file without first asking permission to do so. If this option is activated, you tell ELFTREE not to ask permission. PROFESSIONAL MODE This setting controls whether directories with files in them can be erased, and whether the word 'Drive' should appear under the root directory name on the tree. PROMPT FOR ERASE When this is turned on, each time you tap [F7] or [Del] to erase one or more files, ELFTREE will ask 'Erase Files?' before doing so. This prompt is designed to protect the user who may tap [Del] by mistake when they think they are tapping a different key. Note: Professional mode must be ON to activate this. USE UNIQUE EXIT KEY Some people `lean' a little heavily on [Esc] when backing up from menus, or responding to an option. If ELFTREE is set to Exit to either the Current or Original directory, the user may be tossed out to DOS unexpectedly. This option prevents the [Esc] key from being used to exit from ELFTREE, and allows the user to designate which key to tap to leave ELFTREE. SAVE FILE TAGS To make ELFTREE remember which files are tagged after running a program, set this option to 'Yes'. If the program deletes or creates files, these will be included only when working locally. ENHANCED KEYBOARD Normally, ELFTREE automatically senses whether you have an enhanced keyboard attached to your computer. This option lets you override what is detected. You can also use the command-line switch /Y=# to control this setting. GET TRUE NAMES When you change directories or disks, ELFTREE asks your operating system (DOS, usually) for the logical name of the current directory. If the drive used is not on a network, ELFTREE then asks for the 'actual', or 'true' name (in case the drive was aliased by SUBST). Since this uses a feature of DOS that does not work reliably on all work-alikes (network shells, DR-DOS, etc.), this lets you control when ELFTREE uses it. COMMAND LINE SWITCHES In addition to this customize menu, you can configure ELFTREE with certain command-line switches that you type after the ET that gets ELFTREE up and running. Here are the switches that may be used, and what they represent: /#=- If you prefer not to use '#' as the symbol that identifies a macro symbol (for example, you may have files with '#' in their names), use this to select another symbol. For example, to make '+' the symbol, use /#=+ /4 - Use 4DOS-style note files (file name DESCRIPT.ION). /5 - Use ET-style note files (file name ELFTREE.NTE). /6 - Use ProFinder-style note files (file name TITLES.PF). /C - if you have a composite monitor. /D=#### - Set maximum # of directories to handle. Each uses 16 bytes. (max is 3,999; default is 1000) /F=#### - Set maximum # of files to handle. Each uses 22 bytes. (max is 16384; default is 5000) /G=#### - Set maximum # of directories that Find can handle. Each uses 64 bytes. (max is 999; default is 50) /H=# - If # is 1, this activates high-speed disk scanning routines for non-networked drives. (default is 1, or ON; /H=0 turns it off) Note: A separate logical variable is maintained for high-speed scanning in the OS/2 Compatibility Box. This switch affects only that variable's setting. /K=#### - If # is at least 10, this refers to the number of internal macro keys to allow. (max is 5000; default is 100) /L=Z - Sets last drive accessible to user. (default is Z) /N=#### - Set maximum number of notes to handle. Each one uses 64 bytes; the space is shared with /G=####. (max is 1,000; default is 50) /R=### - ASCII code of `retag' character to use (1-255). (default is 9, which looks like a hollow circle) /T=### - ASCII code of `tag' character to use (1-255). (default is 4, which looks like a solid diamond) /U=#### - if #### is at least 500, this sets the maximum allowable length of a menu command line. (max is 10,000; default is 500) /Y=# - If you do not have an enhanced keyboard, but you want ELFTREE to think that you do (this will let you use [Ctrl+Del] and other nonstandard keys), use 1 for #. Use 0 for # if you do not want ELFTREE to use any of the enhanced keyboard facilities, even if you have such a keyboard. (default is 1 if an enhanced keyboard is detected, and 0 if not) Here is an example of how to set up ELFTREE to use 2,000 files, 300 directories and 500 notes per directory: ET /F=2000 /D=300 /N=500 Be sure to tap SAVE [F9] if you want these to be permanent. Rearranging The Order of Files Key: [F5] If you can't order the files in the list by sorting them, ELFTREE has a feature just for you. For example, how can you arrange these files: Like this? FIRST .A FIFTH .E SECOND .B FIRST .A THIRD .C SECOND .B FOURTH .D SIXTH .F FIFTH .E THIRD .C SIXTH .F FOURTH .D With ELFTREE, this is no problem. Just highlight the item to move and tap the Rearrange [F5] key (or click on F5). You can now drag the item up or down to a new location by using the [Up] or [Down] keys, or click on another file name to put the file above the one that was clicked on. When it's at the new location, tap [Enter] or [Esc] (or click on them) to quit rearranging. So, in the above example, I would highlight FIFTH.E, tap [F5], tap [Up] 4 times, tap [Enter], then highlight SIXTH.F, tap [F5], tap [Up] 2 times, and tap [Enter]. Note: When you SORT [F2], all rearranging you did previously is cleared, and the items are sorted as you wish. Changing Disks Keys: [F6], [L] or [Shift+disk] To look at a different disk or reread the current directory tap the Change Disk ([F6], [L]) key, then tap the letter of the disk to use. If using the mouse, click on the drive letter to change from the list of drives appearing above the Current Path. Note: Another way is to tap [Shift+disk]. If the drive specified is not available for some reason, you'll be told by ELFTREE when it returns. If you are trying to change to a floppy drive, and ELFTREE detects that the disk is not readable, it will ask if you want to format it. If you do not (it could destroy any data on the disk), simply tap [Enter] to answer NO to this choice. You can change disks from either the file information screen or the directory tree display. If you change from the tree, ELFTREE will automatically get the tree for the disk specified. If you change from the file information screen, ELFTREE will bring up the files in the current directory for that disk. Erasing Files or Directories Keys: [F7], [Del] or [Ctrl+K] You can erase one or several items at a time in ELFTREE. The files can be recovered with a number of utility programs on the market unless you choose to Wipe the files, which causes the files to be completely overwritten with null characters. Disk volume labels can be erased as well. To create a new label, tap [Ctrl+L]. ERASING ONE FILE To erase one file, simply highlight it and tap ERASE ([F7] or [Del]) or click on Del on the mouse toolbar. (Note: [Ctrl+K] can also be used.) A box with ERASE FILE(S)? will appear, to verify that you tapped the intended key. Answer with a tap of the [Y] key or by clicking on the [Yes] box if this is what you meant (or tap [W] or click on [Wipe] to wipe the files). If you did not mean to erase anything, tap [N] or [Esc], and this will be cancelled. Otherwise: If no files are tagged, the highlighted file will be erased. If one or more files are tagged, another box will appear, (if you are not in Immediate mode) asking if the [Hilighted] or [Tagged] files should be erased, or if you want to [Cancel] erasing. If files are tagged, the selected file can be erased by choosing [Hilighted] (tap [H] or click on it with the mouse pointer). If the highlighted item is a directory, and no files are tagged, the message in the box will be REMOVE DIRECTORY? instead. See the discussion further down for more on this. ERASING SEVERAL FILES To erase several files, simply `tag' them and tap the ERASE key. The message ERASE FILE(S)? will appear, to check to see if this is what you want to do. Tap [Y] or select [Yes] to proceed, then tap [T] or select [Tagged] to start erasing the tagged files. To interrupt erasing, tap [Esc] or click on Esc. To resume, tap [R] or click on [Resume]. To cancel, tap [Esc] or select [Cancel]. REMOVING A DIRECTORY Tap [Del] on a selected directory to remove it. Of course, to remove a directory, it (and all of its child directories, if any) must be empty of files. A child directory, if it exists, will appear to the right on the directory tree display. Here's a sample: . . PARENT CHILD1 CHILD2 . . Here, PARENT cannot be removed, even if it has no files in it, unless CHILD1 and CHILD2 are empty. If CHILD1 and CHILD2 are empty, they will be removed immediately and ELFTREE will attempt to remove PARENT. As a convenience, you can remove a directory from either the directory tree display or the file information area. As a further convenience, if you select a directory from the tree that no longer exists, ELFTREE will automatically adjust its tree. This may happen, for example, if you remove a directory using DOS or another program. REMOVING A DIRECTORY (PART II) If you would like ELFTREE to be capable of deleting the files in a directory automatically, instead of having to delete them yourself ahead of time, there is a way to do this. From the Advanced Switches menu under Customize, set Professional mode to Yes (the default is No) to activate it. When Professional mode is active, you will be warned if files exist in one or more directories to be deleted, and a box of choices will appear. The options shown mean: [N] - Cancel delete request. [F] - Erase just the files in the parent and subdirectories, but leave the directory structure intact. [O] - Erase just the files in the parent directory. [S] - Erase ALL files in parent and child directories, and remove the directories as well. [Y] - Erase ALL files in the parent directory, and remove it as well. To select an option, either click on its box or tap the letter that appears in the box. Return To Last Directory Key: [F8] You can quickly return to the directory you were in last by tapping the Last Directory [F8] key or clicking on F8. To return to the directory you left, tap [F8] again. This is handy when you need to compare two directories before copying or moving files from one to another, or if you simply need a quick way to return to where you came from. Compare Directories Tap [Ctrl+F8] (or press [Ctrl] and click on F8) to quickly tag files in the current directory that are also in the last directory you visited, but are not identical due to their having a different size or date/time stamp. Files which are not in the other directory will be 'retagged', which you can promote to 'tagged' with the Tag Retag command. If you wish to also process the previous directory, simply switch back to it with [F8], then select [Ctrl+F8] again. You have two choices on the comparison. The Slow option compares files of the same size on a byte-by-byte basis to see if they are identical. The Fast option does not perform an internal comparison; it just looks at the file properties. Save ELFTREE Settings Key: [F9] When you change ELFTREE outside of the Customize [F4] menus, these changes are not saved until you tap or click on the SAVE [F9] key. This creates a file called ELFTREE.CFG in the directory where ELFTREE's menus, tree maps and Find files are stored. To use a configuration file with a different name, use the environment variable ETCONFIG to set it. For example: set ETCONFIG=MONO.CFG You can VIEW the configuration file with ELFTREE, and can make changes to it with an editor, although this is not recommended. ELFTREE.CFG currently stores such items as the colors to use, the number of lines to use on the screen, the number of lines you were using before invoking ELFTREE, the file search specification, the Find search specification, the name of your editor, any editor parameters you want, etc. The DOS commands you used during a session are saved in ELFTREE.CMD (if you set the switch to save them). Go To Child Directory Key: [Ctrl+Right] If the currently highlighted item in the file information area is a directory, jump into it by tapping [Ctrl+RightArrow] (in Immediate mode, just tap or click on [Enter]). The files in this directory will appear. GO TO PARENT DIRECTORY To quickly go to the parent of the current directory, tap the PARENT [Ctrl+LeftArrow] or [.] key. This will display the files from the parent directory, and the directory just left will be highlighted. If you are in the root directory when you tap this key, you will be moved up to the next previous directory in the list, if one exists. For EGA/VGA Displays Key: [Ctrl+V] If your computer has an EGA or VGA display, you can see more information at a time by changing the number of lines ELFTREE shows on the screen. HOW TO ACTIVATE EGA/VGA MODES To change the number of lines on the screen, just tap [Ctrl+V] (hold down the Ctrl key and tap V). If you are viewing a file, looking at your directories, or looking at the menu screen, you will switch to the next mode automatically. The available number of lines per screen are 25/43 for an EGA, and 25/28/50 for a VGA. So, if your current screen is set for 25 lines, your next one will be 43 for an EGA, and 28 for a VGA. If you tap [Ctrl+V] one more time, you'll get 25 on an EGA, and 50 on a VGA. On a VGA, one more tap will get you back to 25 lines. This is a handy way of getting more information (directories, files, browsed file) on your screen at a time. You will find the directory tree display gives you almost twice as many branches in 43 line mode as in 25, and thus you get a better picture of your disk directory structure. Change File Date and Time Key: [Ctrl+T] You can change the date and time of one or many files with ELFTREE. This is handy, for example, if you are working on a group of files in a project, and you want them all to have the same date and time. To change the date and time for one or more files, tap CHANGE FILE DATE [Ctrl+T]. A box will appear, and you should enter the date and time desired where indicated. Be sure to follow the format supplied in the example. For example: 1-1-90 12:00p is a valid date (Note: Tap or click on [F10] to put in the current date and time.) If no files are tagged, the highlighted file's date and time will be changed to what you specified. If one or more files are tagged, another box will appear, asking whether you want to process the [Hilighted] or [Tagged] files, or just want to [Cancel] the operation. If you have tagged files, you change the highlighted file by either tapping [H] or clicking on [Hilighted]. To change the date and time for the tagged files, just tap [T] or click on [Tagged]. Attributes Key: [A] You can use ELFTREE to provide some additional security to your computer system by marking your important files as `read-only', `hidden', or `system'. Also, ELFTREE will show you the current attributes of the items displayed in the last column. Here is a brief description of what each symbol displayed there means: [R] READ ONLY When you make a file `read-only', you tell DOS that it is not allowed to make changes to the file. This prevents others from erasing it easily. Of course, you can use ELFTREE to erase a `read-only' file, but the DOS Erase command will give you the message `Access denied'. As a rule, you should never make data files `read-only', or else the programs that use them will probably not function correctly. For example, if you make ELFTREE.CFG `read-only', then you will not be able to save any configuration changes you make to ELFTREE. [H,S] HIDDEN/SYSTEM Marking a file as `hidden' or `system' keeps it from being shown by DOS when you give a DIR command (this is true for hidden directories as well). This is a good way to keep casual snoops from seeing what you have on your disks. If you have DOS 3.0 or later, you can hide executable files (such as ELFTREE.EXE), yet still run them as if they weren't hidden! Be careful of unhiding files that come with your software; the files might be part of a copy protection scheme, and unhiding them could prevent the program that uses them from working. NOTE: If you mark files as `hidden', `system', or `read-only', any disk defragmentation program you use will NOT MOVE THESE CLUSTERS. If you want them reorganized, you'll have to change their attributes, then run your defragmentation program, then change them back. Use the ELFTREE Find feature to help you if the files are spread across many directories directories or on many disks. [A] ARCHIVED When you make changes to a file, DOS sets the `archive' attribute to denote that it needs to be backed up. Backup programs that perform so-called `incremental' backups look for files that have their `archive' attribute set. [D] DIRECTORY This marks the item as a directory (as opposed to a file or a disk volume label). ELFTREE can hide directories as well as files, and can make directories `read-only' also. Hiding a directory is a quick way to hide the files it contains as well. [L] LABEL This marks the item as a disk volume label (name on the disk). [N] NORMAL A file with no attributes is called a NORMAL file. Changing Attributes It's easy to change attributes with ELFTREE. Select Attribute from the menu bar, and a box will pop up. In this box will be the attributes you can change (Archive, Read-only, Hidden and System). In front of each of these will be `N/C', which means `no change'. Simply select the attribute you want to change, and tap [Space] or click on it to cycle through the choices. The `Yes' choice means `give the item this attribute', and `No' means `remove this attribute from the item'. After selecting the desired attributes, tap or click on [Enter] and the files/directory will be given these attributes. Note: You can also tap or click on [+] to set an attribute to 'Yes', or tap or click on [-] to remove it. Copying Files and Directories Key: [C] You can copy one or many files (even entire directories) with ELFTREE, and with just a few keystrokes! With a little practice, you'll swear off DOS forever for copying your files. You may be aware already that when you use DOS to copy a file, and already have a file with the same name on the disk, DOS may overwrite that file without any warning message. This can cause you to lose data!! ELFTREE will not overwrite files unless you specifically tell it to do so. Also, if you have a note attached to a file, the note will be copied with the file if there is no file with that name in the directory you are copying to. HILIGHTED Assuming no files are tagged, you can copy a file by selecting the Copy command from the menu bar (tap [C] or click on Copy). If files are tagged, a submenu will appear - select Highlighted from this. Next, find the drive and directory to copy the files to (or make a new directory, if needed), tap [Enter] or double-click on it, and sit back and let ELFTREE copy it. You can duplicate a file by selecting the same directory for the destination, or by using the ["] key. ELFTREE will ask you to enter a name for it, and then proceed to copy it. TAGGED After tagging the files to copy (by tapping [Space], using the TAG menu command or right-clicking on them with the mouse), copy them by selecting Copy Tagged from the menu bar. Next, find the directory to copy the files to (or make a new one, if needed), tap [Enter] or double-click on it, and sit back and let ELFTREE copy the files. If you don't want ELFTREE to ask for permission about replacing files that may exist in the target directory before starting to copy the tagged files, change the Copy Overwrite option in the Advanced Switches submenu under Customizing. Be careful, though - you may replace files you didn't intend to replace! COMBINING TAGGED FILES [&] To combine several files into one, just tag them and use the `&' key to indicate that you wish to copy them into one file. ELFTREE will ask you for the name of the file to copy it into, and then start pouring the contents of these files into the one you specified. COPYING ENTIRE DIRECTORIES ELFTREE can copy entire directories from one disk to another. To do this, you must be looking at the directory tree (tap [D] or click on DirTree to get to it). Now, tag the directories you want copied. Here's how to tag them: 1. Tap [Space] to tag an individual directory. 2. Right-click on a directory touched with the mouse pointer. 3. Tap [T] or click on Tag - to tag the current directory and all of its subdirectories. (Hint: to tag all directories on a disk, move to the root directory before selecting Tagged.) 4. Tap [U] or click on Untag - to untag the current directory and all of its subdirectories. Now, tap [C] or click on Copy, tell ELFTREE what disk to copy to, and sit back and let ELFTREE copy the directories. As ELFTREE copies files, it checks to see if there's enough room on the disk to store the copy. If there is not, and you are copying to a floppy, ELFTREE will tell you there is not enough room to copy the file, and will let you Skip the file, put in a fresh disk and Continue, or Quit copying altogether. If you put in a disk that has not been formatted, ELFTREE will give you an error message (such as "Unreadable disk in Drive A"), and then ask if you want to format the disk right now. Tap [Y] or click on Yes to format it, and ELFTREE will invoke the format program you gave to format the disk. (If you have not supplied ELFTREE with the format program yet, then you will be requested to supply it at this time before proceeding to format.) ELFTREE will not format a drive that is not a floppy, so that you cannot use it to format a hard disk inadvertently. After formatting, ELFTREE will resume copying the files. NOTE: When copying directories, ELFTREE will only copy those files that match the current search specification (set with the F10 key) and attributes. You may want to change the specifications before copying. COPYING TO MORE THAN ONE DIRECTORY ELFTREE can copy one or more files to more than one directory quickly and easily. Here's how: 1. Tag the files to copy (if more than one). 2. Select the Copy tool. 3. Tag each directory you want to copy them to. 4. Tap [Enter] to start copying. COPY TO SAME DIRECTORY ON TARGET DISK To copy one or more files to a directory with the same name on a different drive, just tap [Alt+drive] when asked which drive to copy to. For example, to copy files in C:\WORK to A:\WORK, just tap [Alt+A] when selecting the target disk (with the mouse, just press down [Alt] and click on A). COPY TO CURRENT DIRECTORY ON TARGET DISK To copy one or more files to the current directory on a different drive, just tap [Shift+drive] when asked which drive to copy to (with the mouse, just press [Shift] and click on the drive). EMPTY FILES OR THOSE WITH SPECIAL ATTRIBUTES DOS will not copy files of zero length, and when it copies read-only files, the newly created files will not be read-only. ELFTREE will copy zero-length files and preserve any special attributes (hidden, read-only, etc.) that may have been set. Some older programs use this as a form of copy protection. SPECIAL CHOICES WHEN A FILE ALREADY EXISTS If you are copying to a file that already exists, and have not given ELFTREE blanket permission to overwrite it, then ELFTREE will ask you what to do at that time. Your choices are as follows: No - Don't Replace it Yes - Replace it Append - Add to the end of the file. Edit - Edit the file that already exists. Later - Replace the target files only if they are older than the ones being copied or moved. Overwrite - Replace this file, and give permission to overwrite any others that may exist. Rename - Rename the file (preserving both). View - View the file that already exists. To select one of these choices, either tap the letter of the option or click on it with the mouse. If the file you are about to overwrite is read-only, ELFTREE will ask you for permission to remove this protection before proceeding. If the target file is a directory or label, then ELFTREE will ask you to rename it before proceeding. Directory Display Key: [D] ELFTREE shows the directory structure on your disk in the shape of a tree. This representation makes it easy for you to manage them with a minimum of bother. If a note is attached to the file that stores the tree, it is shown just below the path. If using a mouse, the available drives are listed above the path. Below is a list of helpful keys and a description of what you can do while you are looking at the display of your directories: MOUSE FUNCTIONS Menu Bar Click on a menu selection to activate it. For example, click on Print to activate it. Description Double-click to activate help for the highlighted menu item. Drive List Click on a drive letter to change drives. Current Path Click on Drive portion to change drives, click on path portion to show the previous file information area. ? - Help Click to bring up a help screen of what keys are active. Click on a key to simulate tapping it. Tree Left-click to highlight a directory, right-click to tag or untag a directory, double-click to simulate tapping [Enter] for a directory. Click and hold down a mouse button to move selection bar to another directory (they will be tagged or untagged if the right mouse button is held down). Left Edge Click on left edge of screen to simulate [Left] key. Right Edge Click on right edge of screen to simulate [Right] key. Miscellaneous If a box appears on the screen, clicking inside the box (but not on any 'hot spot') usually does the same action as tapping [Enter]. Clicking outside the box (but not on the mouse toolbar) usually does the same as tapping [Esc] to cancel an action. SOME SPECIAL KEYS [Ctrl+Enter] Selects the highlighted item on the moving-bar menu. [Enter] Selects the directory for display of files, then shows the items in this directory. If copying/moving files, this just selects the destination directory. [Esc] Leaves the directory screen; displays files. [#] Displays directory statistics (# of dirs, # hidden, # tagged, #of files in them, total size of files). [Space] Tags/Untags the highlighted directory, updating the combined size of the files affected, and moves down the column. [Ctrl+V] For EGA adapters, this toggles between 25 and 43 line modes. For VGA, this cycles among 25, 28 and 50 line modes. [Ctrl+Right] Selects the next item on the moving-bar menu. [Ctrl+Left] Selects the previous item on the moving-bar menu. [F1] Brings up help on using Directories. [F2] Displays current status of many ELFTREE settings. [F4] Customizes the style of the tree. [F5] Rescans the subtree from the currently highlighted directory. [L] or [F6] Display directory tree for another disk. or [Shift+disk] [DEL], [F7] Remove highlighted directory and all empty subdirectories. or [Ctrl+K] If Professional Mode is on, you can remove directories with files in them as well. [F8] Toggles whether the [Enter], [Right] and [Left] keys affect the moving-bar menu selections. [F9] Saves the current directory tree to disk. [F10] Changes what files are used when you select move, copy, graft or [Enter]. [C] Copy tagged directories to another disk. [E] Exposes hidden subdirectories of the highlighted directory. [W] or [F] Find a directory by name. (accepts non-DOS names, too!) [Alt+Key] Search for a directory whose first letter matches `Key'. For ex, [Alt+A] looks for the next one that starts with `A'. [=] Searches for a directory name as you type it. [G] Graft (attach) the tagged directories to another directory, either on the same or another disk. The files can be copied or moved. Great for reorganizing your directories or moving some between nodes on a network! [H] or [>] If directories are tagged, this hides them from view (they are still visible from DOS). If none are tagged, this will hide all directories that have not already been hidden that appear to the right of the current column in the tree. (You will be prompted to confirm this.) [M] Move tagged directories to another disk. [N] Make a new subdirectory of the one currently highlighted. [O] or [<] Open Next Level - unhides (opens) the next column of directories that were hidden with the Hide command. [P] Print the directory tree as displayed. [R] Rename the currently highlighted directory. [S] Rebuilds the directory tree for the current disk. [T] Tag the highlighted directory and all subdirectories. [U] Untag the highlighted directory and all subdirectories. MOVING AROUND THE TREE To navigate around the tree display, use these keys: [Right] Moves to the first directory below the current one in the next column. If none, it moves to the next one in the same column. [.] [Ctrl+P] or [Left] Moves to the parent of the current directory. [Up] Moves to the previous directory in this column. [Down] Moves to the next directory in this column. If none, goes one column to the right, if possible. [Home] Moves to the first (root) directory. [End] Moves to the last visible directory. [PgDn] Moves to the last directory on the screen, then to the next screen. [PgUp] Moves to the first directory on the screen, then to the previous screen. [Plus] or [+] Highlights the next directory in the tree. When you reach the end, it starts over at the first directory. [Minus] or [-] Highlights the previous directory in the tree. When you reach the beginning, it starts over at the last directory. TREE WIDTH ELFTREE is sensitive to the length of directory names. Shorter names yield a tree with narrower columns than one with longer names. Thus, more columns of directories are displayed if you keep these names short. (When determining the width of the tree columns, only visible directories are used. So, you can make ELFTREE see only short names by Hiding the ones with long names.) [Del], [F7] ERASE DIRECTORY Once you've deleted all of the items in a directory, you can delete the directory itself by tapping the [F7] or [Del] key or clicking on Del. If successful, the directory tree is updated to reflect the change. If not, you still have files (or nonempty subdirectories) still in the directory. Check the file search specification ([F10] key) to see if it includes all possible files. If subdirectories are still attached to the directory, they will appear to the right of it. You will have to delete the files in these directories before you can delete the 'parent' directory. [C, M] COPY/MOVE DIRECTORIES To copy or move one or more directories, just tag them and tap [C] or [M] (or click on Copy or Move). Next, indicate what disk to copy or move them to, and let ELFTREE do it. The files will be copied or moved to directories with the same name on the target disk. With a mouse, right-click on a directory to tag or untag it. Drag the mouse cursor while holding down the right button to extend the operation as it is moved. [E] EXPOSE DIRECTORY Tap [E] or click on Expose to reveal one or more hidden child directories of the currently highlighted directory. [F] FIND DIRECTORY, Part I To find a directory of a given name, you can search for it by tapping [F] or [W] or clicking on Find. You will be prompted for the name to look for (non-DOS names can be used), then ELFTREE will highlight the next directory that matches what you entered. For example, to find a directory called TREE, you could search for it by typing TR*. ELFTREE would find TREE, of course, but it would also find TROUBLE, TRACK, and other directories that begin with TR. After finding a directory, ELFTREE asks if it should keep looking. If you have the one you want, tap or click on [Enter] to select it, or tap or click on [Esc] to quit searching. This is especially handy when looking at a tree display of a disk with many directories. Using it will help you find the directory you want quickly. [=] FIND DIRECTORY, Part II Another quick way to find a directory is to have ELFTREE search for it as you type its name! To activate this, tap the [=] key once. In the space provided, type the name of the directory you are looking for. As you type the name, the next directory that matches it will be highlighted automatically. Tap or click on [Down] or [Up] for the next or previous match, respectively. [G] GRAFT DIRECTORY To graft one or more directories onto another, just tag them and tap [G] or click on Graft. Next, specify whether the directories should be copied or moved during the grafting process, and what disk to graft the directories onto (you can graft them onto any disk, including the current one). You'll then be shown a directory tree for the target disk. Highlight the directory you want to graft onto, and tap [Enter] to select it and begin the grafting process. Here's an example. Suppose I tag five directories to graft: C:\  DUMMY1  A B  C  D E DUMMY2  1 2 3 DUMMY3 Next, I'll specify that I want these directories moved, that I want drive C, and I'll select DUMMY3 as the target directory. This is what the tree will look like after the grafting is done: C:\ DUMMY1 B E DUMMY2 2 3 DUMMY3 DUMMY1 A C D 1 Notice that, even though DUMMY1 was not able to be removed (it has child directories of B and E), all of the files that it held have been moved to the DUMMY1 child of DUMMY3 (assuming here that the filespec used was *.*). Notice, too that directories C and D are now attached directly to DUMMY1 instead of to B. You can see that grafting directories is a quick way to redo the directory structure of a disk. With ELFTREE, you can graft onto another disk, which is especially handy on networks. [H,<] HIDE DIRECTORY To hide one or more directories, just tag them and tap [H] or [<] or click on Hide. The tagged directories will be immediately removed from view (they still exist, and can be seen from DOS, but are just not shown). To expose them again, move to their parent directory and tap [E] or click on Expose. To hide all directories to the right of the column you are currently in, don't tag any directories - just tap [H] or [<] or click on Hide. You will be asked if you want to hide all directories to the right of the current column. To do so, select [Enter] or [Yes]. To not, tap [Esc] or [N]. To open up the next column of directories that have been hidden in this way, tap [O] or [>]. (This will not display directories that have been hidden after tagging, as described in the preceding paragraph. For this, tap [E] or click on Expose while highlighted the parent directory.) [N] NEW DIRECTORY To create a new subdirectory, just highlight the directory you want to be its `parent' and tap [N] or click on New. You will be prompted for a name to give this `child'. Just type the name, and let ELFTREE make it. If successful, ELFTREE will show the updated tree with the new directory in it (if it fits on the screen, of course). [P] PRINT TREE To print the current directory tree, simply tap [P] or click on Print when you are looking at the tree, and it will be printed immediately. To see how much space is used by files in one or more directories, simply tag the directories to be checked and tap [Y] or click on Yes when asked to show the space used by each tagged directory. [F4] CHANGE TREE STYLE Tap or click on [F4] to change the characters used to show the tree. This may be needed if your printer has a difficult time trying to draw the tree (for example, you might get letters instead of lines). [S] SCAN DISK Sometimes, such as after copying directories to another disk or inserting a new floppy disk into your machine, you may need to rescan a disk to regrow the tree. Simply tap [S] or click on Scan to start the process, wait a few seconds for it to complete, and ELFTREE will display the tree. To grow only the portion of the tree beginning with the highlighted directory, tap or click on [F5] instead of [S] or Scan. If you have told ELFTREE to exclude files with certain attributes from the display, then any directories with these attributes will likewise be excluded when the disk is scanned. ELFTREE is respecting your wish for privacy for these directories. ELFTREE will automatically initiate a scan of your disk if you ask to bring up the tree display while in a directory that was not created with ELFTREE. This is a convenience, so that ELFTREE can give you up-to-date disk information. When ELFTREE builds a new tree by scanning the disk, it reveals all directories that were formerly hidden through use of Hide, as described above. Simply tag them and select Hide to hide them again. Editing A File Key: [E] ELFTREE comes with an editor (ELFEDIT.EXE) that provides the functions and simplicity you need. With it, you can use block commands of copy, cut, paste, print, and save, and can convert a block to UPPER, Proper and lower cases instantly! The editor has support for EGA/VGA displays, 11 keyboard macros for complex editing tasks, adjustable TAB stop settings and a host of other niceties. Best of all, this editor is designed to work not just on one file, but as many as will fit into memory! This lets you transfer your work from one file to many others with speed. You will love it, we're sure. The editor can handle large files - even 500,000 bytes, and a line length of up to 20,000 bytes (the defaults are 65,500 and 1,000), but you can change this. Here's an example of how to command it to use only 5,000 bytes per file, with a line length of 2,000 bytes: ELFEDIT /M=5000 /L=2000 Of course, you can use the editor from the DOS environment as well, and there is one distinct advantage to doing so, namely, you can specify which files to edit by using wildcards. Here's how to load a number of .BAT and .PRG files at once, using only 10000 bytes per file: ELFEDIT *.BAT *.PRG /m=10000 The number of files ELFTREE can edit simultaneously is determined by the size of the editing buffer you select with the /M=##### command-line parameter. If you specify an editing buffer of 500000 bytes, then you'll only be able to edit one file. If you choose a buffer size of 10000 bytes, you'll be able to edit dozens of files. If you are not sure how much memory you have available, use ELFTREE's Space command to tell you. Here is a list of 12 features available to you in the editor: 1. Edit large/multiple files - depending on available memory. 2. FAST Block functions - Copy, Delete, Paste, Print, Save, Convert to UPPER/Proper/lower case, Print Mailing Labels. 3. FAST Column Block functions - Copy, Delete or Paste. 4. FAST Search and Replace - replace a phrase with another. You can confirm each selection, change just one occurrence, or change all of them. Also, you can count the number of times a word or phrase occurs in the file. 5. Merge File - Insert a file into the one currently being edited at the cursor position. 6. Instant Key Help - Tap [F1]. 7. Delete/Copy/Paste single lines quickly. 8. FAST loading - the editor is small, so it loads very quickly, and any file you load displays immediately. 9. FAST Cursor Operations - Immediate Page Up, Page Down, etc., no matter how fast your cursor is. 10. Keyboard Macros - Create and store up to 11 macros for complex repetitive editing chores. 11. Customizability - Customize the video mode (supports 25/43 lines for EGA, 25/28/50 for VGA), the colors, the tabstops, autosave, and backup of files. 12. Load a new file into a fresh buffer - if there is room - or jump to any file currently loaded. USING ANOTHER EDITOR Of course, it's okay if you have another editor you prefer. To use your editor from within ELFTREE, you have to tell ELFTREE how to find it. Tap [F4] for the Customize options, and select [K] for Editor Path. Enter the complete name (with path, if known), any parameters you want included with each invocation, whether it needs lots of memory, and what key it uses for the command [Go To Line #]. Notes: You may use ELFTREE's macro symbols among the parameters. The [Go To Line #] key is only used if you tap [E] while viewing a file with line numbers active, and makes the editor start at the line currently shown at the top of the viewer. (Be sure to save [F9] your configuration before leaving ELFTREE, so this information is remembered.) INVOKING THE EDITOR Once you tell ELFTREE the name of your editor, and what parameters you want to use with it (macro symbols can be used), it is available for use by selecting EDIT from the menu bar. (Tap [E], or highlight EDIT and tap [Enter].) EDITING MULTIPLE FILES To edit multiple files, just `tag' the files you wish to edit, and select the `Tagged' submenu option under `EDIT'. ELFTREE will supply the names of the tagged files (up to 115 bytes, counting the spaces between the names, if in list form). Finding Files Key: [F] Ever wish you could work with files from dozens of directories and on several disks as if they were in one? For example, you might want to locate all of those files relating to a particular project so you can copy them to a floppy, or transfer them to someone else across the network. With ELFTREE, this is easy. The Find menu selection makes this possible. Notes: To quickly gather all files on all non-floppy drives that match the current file specification, tap or click on [Ctrl+F10] or [F11]. To quickly find a file in the current list, tap the [=] key once, then type its name in the space provided. As you type the name, ELFTREE will highlight the next file that matches it (if any). Tap or click on the [Down] or [Up] key for the next or previous match, respectively. Networked users should set the ETDRIVES environment variable so that ELFTREE will know which drives to search when looking for files. Here's an example of how to set it to search drives C, D, E and F: SET ETDRIVES=CDEF DATE This gathers a group of files within a range of dates. To activate it, select Find Date from the menu bar. Enter a pair of dates for ELFTREE to use when it builds the table of files - only files whose dates are between the ones you supplied will be included. Next, enter a range of filespecs to look through, indicate any special attributes to include, and specify what disks to search on. Finally, if only one disk is chosen to search, ELFTREE will ask if you want to search all of the directories on the disk (for example, you may only want to search one subtree). If you choose No, you'll be asked to tag the directories you want to search, and ELFTREE will only search these directories. Otherwise, ELFTREE will look through all of the directories on the disk, grabbing all of the files matching these specifications. Note: To find all files with a particular date, just type the same date twice to make the pair. GLOBAL This gathers a bunch of files that match a group of filespecs you want to search for. To activate it, select Find Global from the menu bar. You'll be asked to enter the filespecs to look for (feel free to use non-DOS names like *ABC* here, or to put multiple specs on the line, separated by colons), and the file attributes you are interested in. Next, tell ELFTREE what disks to look on - include network drives if you wish them to be searched as well. Finally, if you chose only one disk to search, ELFTREE will ask if you want to search all of the directories on the disk (you may only want to search a particular subtree, for example). If you choose No, you'll be asked to tag the directories you want searched, and ELFTREE will only search these directories. Otherwise, ELFTREE will look through all of the directories on the disk. For Example For example, to find all files that begin with ELF, or have the letters ELF in the name, you would tell ELFTREE to look for: ELF*.*:*ELF* This would match ELFTREE.CHL, BELFRY, etc. As ELFTREE searches for the files, it tells you which directory and disk it is currently looking in. When it completes the search, it displays the files that it found. (If it didn't find any, you'll be returned to what you had previously.) WHAT CAN YOU DO NOW? From the display, you have access to ALL of ELFTREE's usual tools! So, you can tag several files, copy or move them to a particular directory or disk, dupe them, edit them, erase them, print them, rename them, view them, etc. Just use the tools provided to get the job done. LOAD If the highlighted file is a list of files that was saved using the Find Save command, Find Load will load it and show the files. MERGE If the highlighted file is a list of files that was saved with the Find Save command, Find Merge will merge the stored files with the ones you are currently working with (or load them if none are already loaded). PREVIOUS When you select Find Date, Find Global, or Find Text for a search, ELFTREE automatically stores the file information it finds in a file called LASTFIND.ETG. Find Previous loads this list. REFRESH When working with a saved selection of files, the information in them may get stale with age, as files get moved, changed, erased, etc. Find Refresh updates the information kept for each file currently loaded, and removes those that no longer exist where they once did. If you wish to only refresh a few files, just tag them before selecting this tool. SAVE Find Save saves the current file display for later use. If you are working on a global list of files, the file will be saved, with the extension .ETG, either to the directory where ELFTREE is stored or in the directory specified by the environment variable ETFIND. If you are working on a local list of files, this will be saved with an extension of .ETL to the current directory. To make such a file of files auto-loading when ELFTREE starts up, simply use a filename of AUTOET. Such a file is used by ELFTREE if it saves your files before running a program, and is erased when it starts up again. TEXT Find Text gathers files that have a specific piece of text in them. You'll be asked to enter the text to search for, and whether to look only through files in the current directory. If you specify the current directory, it will either search the highlighted file, if none are tagged, or all of the tagged files. When it finds a file that has this text, it `retags' it, otherwise it `untags' it. If you specify a broader search scope, you will be asked for a group of filespecs to search through, then the attributes to include (Directory has no meaning here). Next, you'll be asked for the disks to search on. By default, floppy drives are left out, but you can add them now if you wish them searched. If you chose only one disk to search, ELFTREE will ask if you want to search all of the directories on the disk (you may only want to search a particular subtree, for example). If you choose No, you'll be asked to tag the directories you want searched, and ELFTREE will only search these directories. Otherwise, ELFTREE will look through all of the directories on the disk. When ELFTREE is done searching, it will show all of the files that have this text in it, if any. If none were found, you will be returned to directory you were in before you started the search. ADJUSTING CAPACITY You can adjust the number of directories and files ELFTREE will use (5000 files, 50 directories is the default; up to 999 directories and 16,384 files can be used) for the Find facility. Here's an example of how to start up ELFTREE so that it uses 1000 files and 100 directories: ET /F=1000 /G=100 You must tap or click on [F9] if you want this kept for the next time you start up ELFTREE. Moving Files and Directories Key: [M] You can move one or many files (even entire directories) with ELFTREE, and with far fewer keystrokes than DOS. Also, since ELFTREE will move files to other disks (or other machines on a network), you have much more capability than DOS gives you. If you have a note attached to a file, the note will be moved with the file if there is no file with that name in the directory you are moving to. HILIGHTED Assuming no files are tagged, you can move a file by selecting the Move command from the menu bar (tap [M] or click on Move). If files are tagged, a submenu will appear - select Highlighted from this. Next, find the drive and directory to move the files to (or make a new directory, if needed), tap [Enter] or double-click on it, and sit back and let ELFTREE move it. TAGGED After tagging the files to move (by tapping [Space], using the Tag menu command or right-clicking on them with the mouse), move them by selecting Move Tagged from the menu bar. Next, find the directory to move the files to (or make a new one, if needed), tap [Enter] or double-click on it, and sit back and let ELFTREE move the files. If you don't want ELFTREE to ask for permission about replacing files that may exist in the target directory before starting to move the tagged files, change the Copy Overwrite option in the Advanced Switches submenu under Customizing. Be careful, though - you may replace files you didn't intend to replace! MOVING ENTIRE DIRECTORIES ELFTREE can move entire directories from one disk to another. To do this, you must be looking at the directory tree (tap [D] or click on DirTree to get to it). Now, tag the directories you want moved. Here's how to tag them: 1. Tap [Space] to tag an individual directory. 2. Right-click on a directory touched with the mouse pointer. 3. Tap [T] or click on Tag - to tag the current directory and all of its subdirectories. (Hint: to tag all directories on a disk, move to the root directory before selecting Tagged.) 4. Tap [U] or click on Untag - to untag the current directory and all of its subdirectories. Now, tap [M] or click on Move, tell ELFTREE what disk to move to, and sit back and let ELFTREE move the directories. If you elect to move the directories to another disk, then ELFTREE will copy the files and, if successful, will erase the originals. As ELFTREE copies files, it checks to see if there's enough room on the disk to store the copy. If there isn't, and you are copying to a floppy, ELFTREE will tell you there is not enough room to copy the file, and will let you Skip the file, put in a fresh disk and Continue, or Quit copying altogether. If you put in a disk that has not been formatted, ELFTREE will give you an error message (such as "Unreadable disk in Drive A"), and then ask if you want to format the disk right now. Just answer `Y' to format it, and ELFTREE will invoke the format program you specified to format the disk. (If you have not supplied ELFTREE with the format program yet, you will be requested to supply it at this time before proceeding to format.) ELFTREE will not format a drive that is not a floppy, so that you cannot use it to format a hard disk inadvertently. After formatting, ELFTREE will resume moving the files. After moving the directories, ELFTREE attempts to remove any empty tagged directories from the tree. NOTE: When moving directories, ELFTREE will only move those files that match the current search specification (set under the [F10] key) and attributes. You may want to change the specifications before moving. MOVING TO MORE THAN ONE DIRECTORY ELFTREE can move one or more files to more than one directory quickly and easily. Here's how: 1. Tag the files to move (if more than one). 2. Select the Move tool. 3. Tag each directory you want to move them to. 4. Tap [Enter] to start moving. MOVE TO SAME DIRECTORY ON TARGET DISK To move one or more files to a directory with the same name on a different drive, just tap [Alt+drive] when asked which drive to move to. For example, to move files in C:\WORK to A:\WORK, just tap [Alt+A] when selecting the target disk (with the mouse, just press down [Alt] and click on A). MOVE TO CURRENT DIRECTORY ON TARGET DISK To move one or more files to the current directory on a different drive, just tap [Shift+drive] when asked which drive to move to (with the mouse, just press [Shift] and click on the drive). EMPTY FILES OR THOSE WITH SPECIAL ATTRIBUTES DOS will not copy files of zero length, and when it copies read-only files, the newly created files will not be read-only. ELFTREE will move zero-length files and preserve any special attributes (hidden, read-only, etc.) that may have been set. Some older programs use this as a form of copy protection. SPECIAL CHOICES WHEN A FILE ALREADY EXISTS If you are moving to a file that already exists, and have not given ELFTREE blanket permission to replace it, then ELFTREE will ask you what to do at that time. Your choices are as follows: No - Don't Replace it Yes - Replace it Append - Add to the end of the file. Edit - Edit the file that already exists. Later - Replace the target files only if they are older than the ones being copied or moved. Overwrite - Replace this file, and give permission to overwrite any others that may exist. Rename - Rename the file (preserving both). View - View the file that already exists. If the file you are about to overwrite is read-only, ELFTREE will ask you for permission to remove this protection before proceeding. If the target file is a directory or label, then ELFTREE will ask you to rename it before proceeding. Notes and Files Key: [N] Ever need to attach a brief note to a file? It might be a short description of what the file contains, of what still needs to be done with the file (as a reminder), or whatever. ELFTREE lets you attach a note or up to 52 characters to a file, to erase a note attached to a file, or to search for files whose notes contain a string you are looking for. (One caution, however. You can only use the Note tool when working with one directory of files.) To make ELFTREE display the notes next to the files/directories they belong to, tap the [Tab] or [Shift+Tab] key to step through the file display until the notes appear. ADD OR EDIT A NOTE Choose Note Add to attach a note to the currently highlighted file, or to edit one that has been attached to it. After typing the note, tap or click on [Enter] to keep it. To attach notes to more than one file, just tag them first. To copy a note to another file, choose Note Add and tap [Alt+C] to copy the note to a note clipboard. Then, move to the file you want to attach it to, select Note Add, and tap [Alt+P] to paste it. ERASE A NOTE Choose Note Erase to erase a note that is attached to the currently selected file. To remove notes from more than one file, just tag the files whose notes are to be deleted. FIND A NOTE Once you've added dozens of notes to your files, you may need help locating a particular note. That's what Note Find is designed for. After selecting the tool, type the text to look for. ELFTREE will look through all of the notes it has for the directory, and will tag those files where the note has that text. FOR 4DOS OR PROFINDER USERS If you use 4DOS or ProFinder, you may be aware that they have facilities to attach notes to files. ELFTREE can use these note files instead of creating duplicate ones, but you won't be able to save a note longer than 40 characters. To enable 4DOS-style notes, make the Note Type setting in the Miscellaneous Settings submenu of Customization to 4DOS. For ProFinder-style notes, select a setting of ProF. Also, be sure to use the command-line switch /N=#### to tell ELFTREE the maximum number of notes to reserve space for. Printing With ELFTREE Key: [P] You can print the contents of one or many files, the current list of files in the file information area, or a picture of the directory tree display for the current disk with ELFTREE. PRINT SETTINGS Before ELFTREE prints something (a file, the directory tree, a marked block), you can tell it how you want the output to look. Here are the settings you can configure, and what they mean: Note: Clicking with the mouse in a particular field moves the cursor to that field immediately. PRINT AS IS To make ELFTREE print exactly what's in the file, without converting tabs, printing the filename, paying attention to margins, etc., enter `Y' in this field. If you are in Immediate mode, entering a `Y' will proceed to print immediately. INITIAL SETUP Sent just before each new page is started, the initial setup string can be used to change the number of lines per inch for your printer, to print in a particular typeface or a certain pitch, etc. Note: To put the Escape character on the line for the setup string, tap or click on [Alt+Z]. FINAL SETUP Sent after each file is printed, the final setup string can be used to reset the printer to its former state. PAGE HEADER Use Page Header to print something at the top of each page. Just type it in the space provided. Note: the Top Margin must be at least 2 for the page header to be printed. LEFT MARGIN Enter a number to indicate the number of character positions you wish each line to be indented by. RIGHT MARGIN Enter a number to indicate the last position a character may be printed on a line. A line that is longer than what is allowed by the Left and Right margin settings will be split, with the balance of the line appearing on subsequent lines, as needed. TOP MARGIN Enter a number to indicate the number of blank lines to put at the top of each page printed. BOTTOM MARGIN Enter a number to indicate the number of blank lines to put at the bottom of each page printed. PAGE LENGTH Enter a number to indicate how many lines can be put on a page. For example, if your printer is set for 6 lines per inch, and you are using 11 inch long paper, then use 66 here. The number of text lines printed is this number minus the number of lines used for the top and bottom margins. CHANGE TABSTOP By default, almost all printers expand tabs to the next tab stop, which are usually 8 positions apart. If you wish for ELFTREE to choose a different tab separation, enter a number indicating what you wish for the new tab setting. Clicking with the mouse cycles forward to the next setting. Note: If you are printing a file that was printed to disk from your word processor, we recommend a setting of 0, as the file most likely contains its own margin settings. We also recommend that you enter a `Y' for the Print As Is selection. PRINT FILENAME When you print a file, you may wish the name of the file to appear at the top of each page. If so, enter a `Y' in this box, otherwise enter `N'. Note: the Top Margin setting must be at least 2 for this to have an effect. Clicking with the mouse toggles between Y' and 'N'. LINE NUMBERS If you wish ELFTREE to put line numbers in front of each line that it prints, enter a `Y' for this. Be sure that you enter a value for the Left Margin that will allow sufficient room for the numbers to be printed, otherwise this option is ignored! ELFTREE will print line numbers up to 4 billion plus. Clicking with the mouse toggles between Y' and 'N'. PRINTER PORT Enter `1' to select parallel port LPT1, `2' for LPT2, '3' for LPT3, 'A' for COM1 or 'B' for COM2. Clicking with the mouse cycles forward through these selections. DESTINATION (P/F) If you wish to print to the printer port specified, enter a `P'. If you wish to print to a file, enter an `F' here, and enter a filename for the file to be printed to in the next area. Clicking with the mouse toggles between 'P' and 'F'. PAGE START If you want to start printing beginning with a page other than 1, enter the page in this area. PAGE STOP To print only a portion of the text, specify what page to stop at in this area. PAGE STEP To print every page, use 1 in this area. To print every other page, use a 2 here. For example, to print every even page, starting with page 2, put a 2 in the Page Start area, a sufficiently large number in the Page Stop area, and a 2 in the Page Step area. PRINT ONE FILE To print one file, select Print from the menu bar if no files are tagged and Print Hilighted if one or more are tagged (and not in Immediate mode). Fill in the printer parameters, tap or click on [F10], and ELFTREE will start printing. After the file is printed, ELFTREE will send a form feed to the printer. PRINT SEVERAL FILES To print more than one file, just tag the files to be printed and select Print Tagged from the menu bar. Next, fill in the printer parameters, tap or click on [F10], and ELFTREE will start printing. A form feed will be sent to the printer after each file. PRINT DIRECTORY LISTING To print the current directory listing, just select Print Listing from the menu bar. Fill in the printer parameters and the listing will be sent to the printer in the order currently displayed. You may want to Sort [F2] it and Rearrange [F5] it before printing. If files are tagged, ELFTREE will ask you if you want to include only the tagged files when it prints the listing. If any of the files have a note attached, the note will appear as well. INTERRUPT PRINTING Tap or click on [Esc] to interrupt ELFTREE while it is printing. Then, tap [R] or click on [Resume] to resume, or tap [Esc] or click on [Cancel] to quit. Renaming A File Or Directory Key: [R] You can rename one or many files listed in the file information area, or a disk volume label. In addition, if you have DOS 3.X or later, you can rename directories with ELFTREE. RENAME ONE FILE To rename one file, just highlight it and select Rename (Rename Hilighted if files are tagged and not in Immediate mode). In the box provide, enter the new name for the file then tap or click on [Enter]. ELFTREE will not re-sort the file information area when you rename a file, but you can force it to do this by tapping or clicking on the Sort [F2] key, then [Enter]. RENAME SEVERAL FILES To rename more than one file, just tag them and select Rename Tagged from the menu bar, and ELFTREE will feed them to you for renaming, one by one. If you want to use a pattern to rename all of the tagged files, just type in the pattern (it must either use DOS wildcards, or begin with a period, to be recognized as a pattern by ELFTREE) you want to use for the first file. ELFTREE will sense the pattern and will ask if you want to use this pattern to rename the rest of the files. Tap [Y] or click on [Yes] if you want the rest of the files to be renamed using this pattern. RENAME A DIRECTORY To rename a directory, just highlight it (directories cannot be tagged), select Rename, enter the new name for it, and tap or click on [Enter]. ELFTREE will rearrange the directory tree display, if needed, so that the directories are still in alphabetical order. This saves you the effort of rescanning the disk to rebuild the directory structure. You can rename a directory from the file display or from the tree display. Disk, RAM Space Usage Key: [S] When you want to know how much space is in use by your system, either on a disk or in memory, the Space command will tell you. Select Space from the main menu, and enter the disks you would like information to be reported for. (The default is to present a list of all non-removable drives in your system.) The displayed information will look something like this: Disk Space and/or Memory Usage Disk Remaining Used Total Pct Usage Indicator Tag Size Type C: 104,294K 29,626K 133,921K 22% 9,490K L D: 101,755K 32,166K 133,921K 24% 9,490K L E: 105,183K 28,738K 133,921K 21% 9,490K L F: 218,906K 40,038K 258,712K 15% 10,531K L Sum: 529,906K 130,568K 660,474K 19% Conventional Memory: 655,360 installed, 337,712 free CDROM = C Extended Memory: 15,729K installed, 14,090K free Local = L Expanded Memory: (none) installed, (none) free Network = N CPU Type: 80486 Removable = R Tap a key to continue Note: If any number in this chart ends with 'K', then the number has been rounded to the nearest thousand. If a number ends with 'M', the number has been rounded to the nearest million (1,000,000). Here is an explanation of what each column contains: 1) Disk - Drive letter being reported on. 2) Remaining - Number of bytes available for use on this disk. 3) Used - Number of bytes already in use on this disk by directories, files and system structures. 4) Total - The number of bytes that the disk can hold. 5) Pct - Percentage of total disk space that is in use. 6) Usage Indicator - a graphic picture of how much of the disk's capacity has been used. 7) Tag Size - How much space the tagged files would occupy on the disk. This number will vary depending on the cluster size of the disk. 8) Type - Type of disk (CDROM=C, Local=L, Network=N). Below the disk information are the following rows: A) Sum - Has totals for each column of disk information. B) Conventional Memory - How much memory is installed in your system (up to 640K or 655,356), and how much is of this memory is available for use. C) Extended Memory - How much memory is installed in your system above 1 Megabyte, and how much is of this memory is available for use (usually as XMS memory). D) Expanded Memory - How much memory in your system is managed by an expanded memory manager (v3.2 or v4.0), and how much is available for use. (Some expanded memory managers manage both XMS and Expanded memory from the same pool, so these numbers may be identical to C). E) CPU Type - The type of CPU detected in your system. Together, these figures will help you stay on top of how much disk space your current applications are using on your disk. This will help you to decide when to remove them from the disk, or upgrade the capacity of the disks on your system. To see how much space is used by files in one or more directories, tap [D] or click on DirTree to show the Directory Tree, tag the directories to be checked, and tap [Y] or click on [Yes] when asked to show space used by each tagged directory. Tagging Files Key: [T] ELFTREE can perform many of its operations on either one file or several. The mechanism by which you tell ELFTREE which files to use for your next operation is called TAGGING, and there are many ways to do it. After you have learned how to tag files, you are ready to discover the real power of ELFTREE. By tagging files, you can instruct ELFTREE to work with a diverse group of them with just a couple of keystrokes. TAG HIGHLIGHTED FILE ONLY If the currently highlighted item in the file information area is a file, you can tag it by tapping [Space]. When you do this, a '' symbol will appear to the left of the file name, and the totals for tagged files at the bottom will change to reflect your action. To untag a file, just highlight it again and tap [Space]. This will remove the `', and the totals will change accordingly. With a mouse, right-click on a file to tag or untag it. Drag the mouse cursor while holding down the right button to extend the operation as it is moved. Note: Directories cannot be tagged. When the highlighted item is a is a directory and you tap [Space], the highlight moves to to the first file after the directory, if possible. To tag or untag more than a few files, use the TAG menu selection to reveal some additional choices. Here is a description of each: ALL Tag All will 'tag' all files in the file information area. DIFF Tag Diff will compare the files in this directory to the one in the last directory you were in, and will `tag' those files that are not identical. You will be asked whether you want the files compared by bytes, which takes longer, or by properties, which just compares the sizes and date/time stamp. Tap [S] or click on [Slow] for the slower operation, or tap [F] or click on [Fast] for the faster one. If you choose [Slow], you must tag the files you want compared if you want to compare more than one. After comparing each pair of files, the file in the current directory is either tagged, retagged, or untagged, according to whether the file in the other directory is different, does not exist, or is found to be identical, respectively. The keystroke sequence [Ctrl+F8] also activates this feature. DUPE Tag Dupe appears only if you use Find to gather files from different directories. It will `tag' those files that have the same name as another file (or directory) in the list. To move among the duplicate file names, tap the '>' and '<' keys (these are specially designed to move among tagged files). The keystroke sequence [Ctrl+F8] also activates this feature. GROUP Tag Group will let you specify one or file name patterns for tagging. Here are some examples: *.EXE - tags all files with an extension of `.EXE' TR*.* - tags all files that begin with `TR' BA*.PAS - tags all files that begin with `BA' and have an extension of `.PAS' ???.* - tags all files that have three letters in their filename and may or may not have an extension. *A*B* - tags all files with an 'A' and a 'B' in the name, with the 'B' following the 'A'. HIGH Tag High will `tag' all of the files above the highlight bar, but will not tag the highlighted file. This is handy, for example, when the files are sorted by date/time, and you want to tag all of the files that are before or after a certain date. INVERT Tag Invert will cause all tagged files to become untagged, and all untagged files to be tagged. This is most useful when you want to tag all but a few of the files in the current directory. In this scenario, you would tag the files you DON'T WANT, then choose Tag Invert. Presto! The files you do want are now tagged. KEEP Tag Keep will restrict the file display to only those files that are tagged. For example, you may wish to work with files relating to a particular project, and no others. To do this, just tag the files you want kept for the display and select Tag Keep. If you wish to save this file list, choose Find Save. As another example, if you have previously done a Tag Dupe to mark files with duplicate names, Tag Keep will drop all others from the group. LOW Tag Low will tag the files below and including the highlighted one. This is handy, for example, when the files are sorted by date/time, and you want to tag all of the files that are before or after a certain date. NOTES Tag Notes will tag all files in the list that have a note attached to them. RETAG After ELFTREE performs an operation on one or more files, it puts a small `o' in front of it where the `' was. This tags the files again, which includes them in the next group operation. UNTAG Tag Untag will untag some or all of the files in the file information area. If you have one or more files tagged (denoted by a solid diamond), and others are retagged (denoted by a hollow circle), then ELFTREE will just clear the tags off of the ones marked with the diamond. If no files are tagged, then all of the retag symbols will be cleared. This two-step process lets you isolate the files that are retagged for a particular operation. As an example, you might use the Tag Diff selection to compare two directories, which leaves some files tagged (which means they are in both but are not identical) and others retagged (which means that they are not in the other directory at all). By clearing the tagged files, you can then use Tag Retag to select the files that did not exist in the other directory, then use Copy Tagged to copy them over to it. Viewing A File Key: [V] ELFTREE can show you the contents of any file on your disk, no matter how large it is. This is handy when you need to take a peek inside a file, but your editor cannot handle it. For example, you might want to look at the documents in your word processing directory to see which ones were memos to your boss. VIEWING MODES ELFTREE can display your file in one of these modes: Hex - ASCII on the right, corresponding HEX on the left. Normal - Filtering of carriage return/line feed pairs only. High Bit Off - Only use lower 7 bits of each character. Text&Graphics - Skip control characters (below 32). Text Only - Skip control and graphics characters (above 126). A-Z, a-z - Show alphabetic characters only. In addition, you can select whether long lines of text should wrap around when the screen border is reached. (When wrapped, a ruler line appears just above the display area for your convenience.) Note: Only text files can wrap; binary files cannot. ACTIVE KEYS These keys are available while viewing a file: [Ctrl+V] For EGA, this toggles between 25 and 43 line modes. For VGA, this cycles among 25, 28 and 50 line modes. [A] Repeats search for text (top-to-bottom). [Alt+A] Repeats search for text (bottom-to-top). [B] Mark beginning/end of a block in the file. [C] Change case used for text search. [Shift+TAB], [TAB],[D] Change text filter used for displaying file. [E] Leaves viewer, invokes editor for this file. [F] Initiates search for text (top-to-bottom). [Alt+F] Initiates search for text (bottom-to-top). [H] Toggles the HEX display filter. [J] Jump to specific position in file being viewed. [L] Toggles whether line numbers are shown or not. [O] Toggles whether orphaned [CR] and chars are treated as as end-of-line characters. [R] Enter replacement text. [Alt+R] Apply replacement text. [T] Toggles whether tabs are expanded or not. [U],[Alt+U] Replace replacement text with found text. [W] Toggles wrapping of long lines. [I], [Alt+I] Toggles translation from IBM EBCDIC to ASCII. [Alt+1]-[Alt+8] Changes tabstop expansion to 1-8, respectively. [+ or -] Increases or Decreases tabstop setting by 1. [F5] Marks the file as a block and activates block menu. [F8] Toggles whether the [Enter], [Right] and [Left] keys affect the moving-bar menu selections. [F9] Moves backward 1/3 page in the file. [Ctrl+Left, Ctrl+Right] Selects previous, next item on the moving-bar menu. [Ctrl+Enter] Selects the highlighted menu item. [Enter] same as above. [Right] If Menu is active, highlights next menu item, otherwise moves forward 1 byte in the file. [Left] If Menu is active, highlights previous menu item, otherwise moves backward 1 byte in the file. [Up, Down] Moves backward, forward 1 line in the file. [PgUp, PgDn] Moves backward, forward 1 page in the file. [Home, End] Moves to beginning, end of file. [Delete] Erases the file (after prompting). [ < , > ] Views previous, next tagged file in the list. [Ctrl+PgUp, Ctrl+PgDn] Views previous, next file in the list. BRING UP EDITOR [E] You can bring up your editor to work on the file you're currently viewing by tapping [E] or clicking on Edit. This is handy if you see a need for changes in the file you're viewing. CUSTOMIZABLE TAB STOPS [T,+,-] If you regularly browse text files, you'll appreciate a special feature of ELFTREE. You can tell ELFTREE whether to expand tabs to selected tab stop settings or not and, if they are expanded, how far apart the tab stops should be (from 1 to 8). If you program, this makes it much handier to view listings. The current mouse setting is in middle of the last screen line. Using the mouse, click on [+] to increase the tabstop setting, and [-] to decrease it. FOR EGA and VGA DISPLAYS [Ctrl+V] While viewing a file, you can advance or go backward one line at a time (two if in hex display mode) or one screen at a time. You can also change the display (if you have an EGA) to 43 line mode from 25 line mode or vice versa. If you have a VGA, you cycle among 25, 28 and 50 line modes. (The keystroke [Ctrl+V] activates this. Hold down the [Ctrl] key, tap [V] once, then release both.) AUTOMATIC SCROLLING [1..9] You can scroll either forward or backward in your file at varying speeds. To do this, tap either the UpArrow or DownArrow keys (this tells ELFTREE what direction to scroll), and then the speed (1 - 9) digit. A speed of 1 is slowest, and 9 is the fastest. You can adjust the speed during scrolling by tapping the digit corresponding to the new setting. To stop scrolling, tap [0]. (The key you tap will be acted on, so if you touch [E], for example, you will stop scrolling and invoke the editor. With the mouse pointer on the bottom line of the screen, click on [123456789] to select or change a scroll speed. FIND TEXT [F] You can tell ELFTREE to look for text in the file. Tap [F] or click on Find and, in the box that appears, type the text to search for. To begin the search, tap or click on [Enter]. If ELFTREE does not find it, you will be told, otherwise the text will appear near the top of the screen. To repeat the search, tap [A] or click on Again. Note: The above directions assume you want to search from the current position in the file to the end of the file (called top-to-bottom searching). If you want to search in the opposite direction, use [Alt+F] and [Alt+A] instead of [F] and [A], respectively. To search for a hexadecimal text string such as 'CD 21' (ignore the quotes), you would enter CD 21 in the window, then tap or click on [F10] to begin the search. JUMP AROUND IN FILE [J] You can jump to a specific position in the file being viewed. Tap [J] or click on Jump, type in the position to jump to, then tap or click on [Enter]. For example, if you're viewing a 24 million byte file, you can jump to the 2 millionth character by entering 2M, 2000K or 2,000,000. The suffix `M' is treated as `Million' and the suffix `K' is treated as `Thousand'. The first byte in the line of text starting in the upper left corner of the viewing area is the byte at this position. You can also enter the position as a hexadecimal (base 16) number. For example, if you wish 2M to be treated as 2 Megabytes, enter it as X2M (the leading `X' indicates that it's in base 16, or `hex'). Of course, you can enter a `hex' number directly, such as FFFF (which is 65,535 in decimal). You only need to use the leading `X' for hexadecimal numbers if there are no `hex' numerals in the position you specify. LINE NUMBERS [L] When you select a file to view, ELFTREE initializes counters to keep track of what line you are currently on, and what position you are at. If you want to see the line numbers, tap [L] or click on Line once. If you prefer to see the position, tap [L] or click on Line to turn the numbers off. If line numbers are shown and you tap [E] or click on Edit to edit the file being viewed, ELFTREE can make your editor start at the current line! This saves you from having to remember what line you were at, then issue a [Go To Line #] command in your editor. Note: ELFTREE may not be able to keep track of the line number at all times; in these cases only your Position in the file will be given; when ELFTREE can compute your line number position again, it will show it. ORPHAN [CR] [O] Sometimes, files produced by DOS or other programs contain a carriage return [CR] (ASCII 13) character without a line-feed character (ASCII 10) to follow it (which makes ELFTREE start a new line). Also, some word processing programs use the symbol ` ' (ASCII 11) to denote an end-of-line character. To make ELFTREE recognize these symbols as additional end-of-line characters, tap [O] once. REPLACE TEXT [R],[Alt+R] When you have found a piece of text while viewing a file, you can replace it with one of the same length (padded with spaces, if needed). Here's how to do this: 1. Tap [F] or [Alt+F] (or click on Find) to enter the text to search for and to find the next occurrence of it. 2. Tap [R] to enter the text to replace it with. If the text is shorter than what you're looking for, it will be padded with spaces. 3. Tap [Alt+R] to replace this occurrence of the text; otherwise, tap [A] or [Alt+A] or click on Again to find the next occurrence of it. 4. To undo a replacement, tap [U] or [Alt+U] to replace the occurrence with the text being searched for. Note: If no Find is in effect, text can be replaced at the position of the cursor. Just tap [R] to enter the replacement text and [Alt+R] to apply it. TRANSLATE IBM EBCDIC [I] When viewing a file that is stored in IBM EBCDIC format, you won't be able to read it easily, since your computer is designed to use ASCII characters. However, ELFTREE can translate these characters to ASCII for you - just tap [I] or click on IBM to activate it. To just convert EBCDIC digits (hex F0 through F9) to ASCII digits, tap [I] or click on IBM until the EBCDIC 0-9=>ASCII symbol appears. When activated, you will be able to read the translated text as if it were stored in ASCII, and you can use ELFTREE's usual viewing filters on the translated text as well. If the file being viewed is ASCII text, and you want to convert it to EBCDIC, just keep tapping [I] or clicking on IBM until the ASCII<=EBCDIC symbol appears. To just convert ASCII digits (0 through 9) to EBCDIC digits, tap [I] or click on IBM until the ASCII 0-9=>EBCDIC symbol appears. When you mark a block (see next section) and append it to a file with this feature activated, the text appended will be translated according to the current translation mode in effect. For example, if EBCDIC=>ASCII is in effect, the appended text will be in ASCII. WORKING WITH BLOCKS [B] While viewing a file, you may wish to: A. Print a portion of it B. Append a portion to another file C. Convert a portion to UPPER case D. Convert a portion to lower case E. Convert a portion to Proper case F. Replace a portion with some character G. Replace all Nulls (hex 00) in a portion H. Replace all Control chars in a portion I. Strip the High bit from all characters in a portion J. Delete the block of text from the file. With ELFTREE, this is easy, and requires no programming. Simply move to the start of the block you wish to use, tap [B] or click on Block to indicate that you want to define a Block (the block is marked at your current position in the file, which is the position of the first character in the file viewing area), then move to the end of the portion, and tap [B] or click on Block again. A menu of block commands will appear. Just select the command you want, and it will be processed immediately, leaving you at the menu in case you wish to use another command as well, or to repeat a previous one. When you leave this menu, your block becomes unmarked. You can use a block as large as the entire file you are viewing. To quickly select the entire file as a block, tap or click on [F5]. Note: The RightArrow and LeftArrow keys will move you one position in the corresponding direction. These are especially handy for marking EXACTLY the block you need. EXTENSION SENSITIVITY You can train ELFTREE to bring up your word processing viewer when the currently highlighted file has an extension of, say, DOC, or to load your spreadsheet viewer when the current file's extension starts with a W. To do this, create an ASCII file with this layout (tap [Alt+Enter] when viewing to automatically edit the file): DBF C:\TREE\VIEWDBF.EXE DOC C:\WP\WPVIEW.EXE -x (parameters can be used) TXT (ELFTREE uses internal viewer) W* C:\SS\VSHEET.EXE ZIP D:\PKZIP -v {Fname} (macro symbols can be used) Save this file under the name VIEWERS.ELF in the same directory that the other ELFTREE files are located. The next time you load ELFTREE, it will be `sensitized' to these extensions. This means, for example, that when you highlight the file REPORT.DOC and tap [V], this command is performed: C:\WP\WPVIEW.EXE -x REPORT.DOC You can choose up to 40 extensions for ELFTREE to be aware of, and the extensions can use the DOS wildcards `*' and `?'. Notes: ELFTREE will allow you to have multiple VIEWERS.ELF files. When you enter a directory, ELFTREE looks for a VIEWERS.ELF file and, if it finds one, `resensitizes' itself to what is in this new one. When you then move on to another directory, ELFTREE stays sensitive to these extensions. If the extension of the file does not match any of the extensions in VIEWERS.ELF, ELFTREE uses its internal viewer. See the help on DOS Gateway for related information. PROGRAMMING THE INTERNAL VIEWER As you experiment viewing different files with ELFTREE, you may notice that you prefer to view some of them one way, and others another way. For example, files with an .EXE or .COM extension often are best viewed with the Hex filter active, while normal text files are best viewed with Wrap off, using the CR/LF filter. You can make ELFTREE automatically activate several viewing options by specifying your preferences in this VIEWERS.ELF file. Here are some examples to show you how to do this. Note the `=' symbol, used to indicate that what follows applies to the internal viewer. ASM =H- T8 W M- (Hex off; Tabstop=8; Wrap on) EXE =H M- (Hex on; Menu inactive) TXT =H- W- T3 (Hex off; Wrap off; Tabstop=3) * =D1 T0 M (CR/LF; Tabs off; Menu active) In general, a symbol followed by a `-' means `turn this off'. A symbol followed by a space means `turn this on'. Here is a list of what symbols can be used, and how to use them: Symbol Modifier Description ====== ======== ====================================== C 0 - 3 Case for text searches. D 0 - 5 Display filter to use. H - Hex filter off/on. I - IBM EBCDIC to ASCII translation off/on. L - Line numbers shown or not. O - [CR], recognized as end-of-line or not. M - Menu active or not. T 0 - 8 Tabstop distance (0=off, 1-8=on). W - Wrap long lines off/on.